# List sub-merchants

Get a list of all sub-merchants associated with your parent merchant account.

Endpoint: GET /merchants
Version: 1.0.0
Security: ApiKeyAuth

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    The unique identifier for the sub-merchant
    Example: "mrc_3bbb4fe7-4c25-45b2-a363-c8db8c0084b9"

  - `data.display_name` (string)
    The display name of the sub-merchant
    Example: "Sub-Merchant Store"

  - `data.legal_name` (string)
    The legal name of the sub-merchant
    Example: "Sub-Merchant Store"

  - `data.merchant_type_id` (string)
    The type ID of the sub-merchant
    Example: "BUSINESS"

  - `data.merchant_category_id` (string)
    The category ID of the sub-merchant
    Example: "ENERGY"

  - `data.country_code` (string)
    The country code of the sub-merchant
    Example: "US"

  - `data.status` (string)
    The status of the sub-merchant. TEST_MODE is only for sandbox accounts.
    Enum: "ONBOARDING", "ACTIVE", "TEST_MODE"

  - `data.parent_id` (string)
    The unique identifier for the parent merchant
    Example: "mrc_3bbb4fe7-4c25-45b2-a363-c8db8c0084b9"

  - `metadata` (object)

  - `metadata.total` (integer)

  - `metadata.limit` (integer)

  - `metadata.offset` (integer)


## Response 401 fields

## Response 403 fields

## Response 500 fields