---
title: "Get Merchant Status"
method: GET
path: "/v1/merchants/{merchant-id}/status"
tags: ["Merchants"]
---

# Get Merchant Status

`GET /v1/merchants/{merchant-id}/status`

## Request

- Base URL: `https://api.sandbox.eu.ppro.com`
- URL: `https://api.sandbox.eu.ppro.com/v1/merchants/{merchant-id}/status`
- Auth: none required

## Path parameters

- `merchant-id` string, required: Unique identifier for the merchant

## Response `200`

Merchant status

- MerchantStatusResponse: Merchant status.
  - `status` 'PENDING' | 'ACTIVE' | 'SUSPENDED' | 'CLOSED', required: Merchant lifecycle status.
  - `reasonCode` string: Reason code for the merchant status.
  - `capabilities` MerchantStatusCapabilities, required: Capability flags of a merchant.
    - `canPay` boolean, required: Whether the merchant can process payments.
    - `canRefund` boolean, required: Whether the merchant can process refunds.
  - `createdAt` string, date-time, required: Timestamp when the resource was created. UTC timezone. Format YYYY-MM-DDTHH:MM:SS.ssssssZ
  - `updatedAt` string, date-time, required: Timestamp when the resource was last updated. UTC timezone. Format YYYY-MM-DDTHH:MM:SS.ssssssZ

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Resource not found
- `405`: Method not allowed
- `429`: Too many requests
- `500`: Internal Server Error
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/ppro/apis/onboarding.md) - [All operations](https://skmtc.dev/ppro/apis/onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/ppro/apis/onboarding/revisions/32c4db4523ac?raw)