# Retrieve a merchant

Retrieves details of a specific merchant by their merchant ID.

Endpoint: GET /platform/merchants/{merchant_id}
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Path parameters:

  - `merchant_id` (string, required)
    Unique identifier of the merchant. Starts with `merch_` followed by letters and digits. An ID of any other shape is rejected with `400` and a message saying it must start with `merch_`; a well-formed ID that doesn't match a merchant under your platform account returns `404`.

## Response 200:

  - `200` (unknown)
    Merchant retrieved successfully

## Response 200 fields (application/json):

  - `owner_merchant_id` (string, required)
    The ID of the platform/owner merchant
    Example: merch_68511919RVuf6

  - `merchant_id` (string, required)
    Unique identifier for the merchant
    Example: merch_68c777fcOOMpl

  - `status` (string, required)
    Current onboarding status of the merchant.
- `created` — the merchant has been submitted and screening has not finished.
- `action_required` — screening flagged the merchant and Glomo is reviewing it before onboarding
can continue.
- `pending` — screening passed and the merchant's KYC or KYB review is in progress.
- `success` — the merchant is onboarded and can transact.
- `failed` — onboarding was rejected. Terminal.
- `offboarded` — a previously onboarded merchant has been removed. Its API keys stop working and it
can no longer transact. Terminal.
    Enum: "created", "action_required", "pending", "success", "failed", "offboarded"

  - `name` (string, required)
    Name of the merchant
    Example: John Doe

  - `category` (string)
    Business category
    Example: Agricultural Services

  - `entity_type` (string)
    Type of merchant entity
    Enum: "individual", "business"

  - `sub_category` (string)
    Business sub-category (must be paired with correct category)
    Example: Veterinary Services

  - `gender` (string)
    Gender (only required for individual entity_type)
    Enum: "male", "female", "undefined"

  - `date_of_birth` (string)
    Date of birth, as a calendar date in `YYYY-MM-DD` format with no time or time zone. Present only when `entity_type` is `individual`.
    Example: 2001-08-04

  - `registration_number` (string, required)
    Business registration number or individual ID
    Example: REG123456

  - `registration_country` (string, required)
    Country where the merchant is registered (ISO 3166-1 alpha-3)
    Example: IND

  - `address` (object, required)
    Merchant address

  - `address.address_line1` (string, required)
    Primary address line
    Example: 123 Main St

  - `address.address_line2` (string)
    Secondary address line (optional)

  - `address.city` (string, required)
    City name
    Example: Bangalore

  - `address.state` (string, required)
    State or province
    Example: Karnataka

  - `address.pincode` (string, required)
    Postal/ZIP code
    Example: 560060

  - `address.country` (string, required)
    Country code (ISO 3166-1 alpha-3)
    Example: IND

  - `operation_countries` (array, required)
    List of countries where the merchant operates
    Example: ["IND"]

  - `created_at` (string, required)
    When the merchant was created, as an ISO 8601 date-time in UTC.
    Example: 2025-10-07T06:11:47Z

  - `updated_at` (string, required)
    When the merchant was last updated, as an ISO 8601 date-time in UTC.
    Example: 2025-10-07T06:11:47Z

  - `jwt_token` (string, required)
    JWT token for the merchant
    Example: child_merchant_JWT

  - `public_key` (string)
    public key for the merchant
    Example: live_6889e287VfqrPVPg

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Example: Bad Request

  - `message` (string)
    Example: Invalid merchant ID format

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `error` (string)
    Example: unauthorized

  - `message` (string)
    Example: Invalid or missing authentication token

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `error` (string)
    Example: Not Found

  - `message` (string)
    Example: Merchant with the specified ID was not found