---
title: "Get a list of merchant accounts"
method: GET
path: "/merchants"
tags: ["Account - merchant level"]
---

# Get a list of merchant accounts

`GET /merchants`

Returns the list of merchant accounts that your API credential has access to. The list is grouped into pages as defined by the query parameters. 

To make this request, your API credential must have the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Account read

## Query parameters

- `pageNumber` integer
- `pageSize` integer

## Response `200`

OK - the request has succeeded.

- ListMerchantResponse
  - `_links` PaginationLinks
    - `first` LinksElement, required
      - `href` string
    - `last` LinksElement, required
      - `href` string
    - `next` LinksElement
      - `href` string
    - `prev` LinksElement
      - `href` string
    - `self` LinksElement, required
      - `href` string
  - `data` Merchant[] — The list of merchant accounts.
    - `_links` MerchantLinks
      - `apiCredentials` LinksElement
        - `href` string
      - `self` LinksElement, required
        - `href` string
      - `users` LinksElement
        - `href` string
      - `webhooks` LinksElement
        - `href` string
    - `captureDelay` string — The [capture delay](https://docs.adyen.com/online-payments/capture#capture-delay) set for the merchant account. Possible values: * **Immediate** * **Manual** * Number of days from **1** to **29**
    - `companyId` string — The unique identifier of the company account this merchant belongs to
    - `dataCenters` DataCenter[] — List of available data centers. Adyen has several data centers around the world.In the URL that you use for making API requests, we recommend you use the live URL prefix from the data center closest to your shoppers.
      - `livePrefix` string — The unique [live URL prefix](https://docs.adyen.com/development-resources/live-endpoints#live-url-prefix) for your live endpoint. Each data center has its own live URL prefix. This field is empty for requests made in the test environment.
      - `name` string — The name assigned to a data center, for example **EU** for the European data center. Possible values are: * **default**: the European data center. This value is always returned in the test environment. * **AU** * **EU** * **US**
    - `defaultShopperInteraction` string — The default [`shopperInteraction`](https://docs.adyen.com/api-explorer/#/CheckoutService/v68/post/payments__reqParam_shopperInteraction) value used when processing payments through this merchant account.
    - `description` string — Your description for the merchant account, maximum 300 characters
    - `id` string — The unique identifier of the merchant account.
    - `merchantCity` string — The city where the legal entity of this merchant account is registered.
    - `name` string — The name of the legal entity associated with the merchant account.
    - `pricingPlan` string — Only applies to merchant accounts managed by Adyen's partners. The name of the pricing plan assigned to the merchant account.
    - `primarySettlementCurrency` string — The currency of the country where the legal entity of this merchant account is registered. Format: [ISO currency code](https://docs.adyen.com/development-resources/currency-codes). For example, a legal entity based in the United States has USD as the primary settlement currency.
    - `reference` string — Reference of the merchant account.
    - `shopWebAddress` string — The URL for the ecommerce website used with this merchant account.
    - `status` string — The status of the merchant account. Possible values: * **PreActive**: The merchant account has been created. Users cannot access the merchant account in the Customer Area. The account cannot process payments. * **Active**: Users can access the merchant account in the Customer Area. If the company account is also **Active**, then payment processing and payouts are enabled. * **InactiveWithModifications**: Users can access the merchant account in the Customer Area. You cannot process new payments but you can still modify payments, for example issue refunds. You can still receive payouts. * **Inactive**: Users can access the merchant account in the Customer Area. Payment processing and payouts are disabled. * **Closed**: The account is closed and this cannot be reversed. Users cannot log in. Payment processing and payouts are disabled.
  - `itemsTotal` integer, required — Total number of items.
  - `pagesTotal` integer, required — Total number of pages.

## Other responses

- `204` — No Content - the request has been successfully processed, but there is no additional content.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/management-api.md) · [All operations](https://skmtc.net/adyen/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/management-api/versions/1089ade06e17/schema)