---
title: "GET /tenants/{tenantId}/merchants"
method: GET
path: "/tenants/{tenantId}/merchants"
tags: ["Tenants"]
---

# GET /tenants/{tenantId}/merchants

`GET /tenants/{tenantId}/merchants`

## Path parameters

- `tenantId` string, uuid, required

## Query parameters

- `page` integer
- `start` string
- `size` integer

## Response `200`

Success

- TenantMerchantPaginatedList
  - `pagination` Pagination
    - `total_items` integer, nullable
    - `page_number` integer, nullable
    - `page_size` integer, nullable
    - `total_pages` integer, nullable
    - `after` string, nullable
    - `next` string, nullable
  - `data` TenantMerchant[], nullable
    - `id` string, uuid
    - `tenant_id` string, uuid
    - `name` string, nullable
    - `details` MerchantDetails
      - `merchant` MerchantInfo
        - `full_legal_name` string, nullable
        - `doing_business_as` string, nullable
        - `parent_company_name` string, nullable
        - `website_url` string, nullable
        - `category_code_mcc` string, nullable
        - `descriptor` string, nullable
        - `business_description` string, nullable
        - `registration` MerchantRegistration
          - `registration_type` string, nullable
          - `registration_id` string, nullable
          - `vat_id` string, nullable
        - `contact` MerchantContact
          - `name` string, nullable
          - `title` string, nullable
          - `phone_number` string, nullable
          - `email` string, nullable
        - `address` MerchantAddress
          - `street_1` string, nullable
          - `street_2` string, nullable
          - `city` string, nullable
          - `state_province` string, nullable
          - `postal_code` string, nullable
          - `country` string, nullable
      - `card_network_info` CardNetworkInfo
        - `visa` VisaConfig
          - `acquirer_bin` string, nullable
          - `card_acceptor_id_caid` string, nullable
        - `mastercard` MastercardConfig
          - `merchant_id_mid` string, nullable
        - `amex` AmexConfig
          - `se_number` string, nullable
        - `discover` DiscoverConfig
          - `merchant_id_mid` string, nullable
    - `services` MerchantServices
      - `account_updater` ServiceStatus
        - `status` string, nullable
        - `providers` string[], nullable
        - `card_network_status` CardNetworkStatus
          - `visa` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `mastercard` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `amex` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `discover` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
      - `network_token` ServiceStatus
        - `status` string, nullable
        - `providers` string[], nullable
        - `card_network_status` CardNetworkStatus
          - `visa` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `mastercard` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `amex` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `discover` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
      - `agentic_commerce` ServiceStatus
        - `status` string, nullable
        - `providers` string[], nullable
        - `card_network_status` CardNetworkStatus
          - `visa` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `mastercard` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `amex` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
          - `discover` NetworkStatusDetail
            - `status` string, nullable
            - `status_reason_code` string, nullable
            - `status_reason` string, nullable
            - `status_reason_label` string, nullable
    - `created_by` string, uuid, nullable
    - `created_at` string, date-time, nullable
    - `modified_by` string, uuid, nullable
    - `modified_at` string, date-time, nullable

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/basistheory/apis/basis-theory-api.md) · [All operations](https://skmtc.net/basistheory/apis/basis-theory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/basistheory/basis-theory-api/revisions/cbb8e098b560/schema)