# 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

## Path parameters:

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

## 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)
    Status of the merchant onboarding
    Enum: "success", "pending", "failed"

  - `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 (only required for individual entity_type)
    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)
    Timestamp when the merchant was created
    Example: "2025-10-07T06:11:47Z"

  - `updated_at` (string, required)
    Timestamp when the merchant was last updated
    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 fields (application/json):

  - `error` (string)
    Example: "Bad Request"

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

## Response 401 fields (application/json):

  - `error` (string)
    Example: "unauthorized"

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

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Not Found"

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