> For the complete documentation index, see [llms.txt](https://docs.payengine.co/payengine-api-v2.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/payengine-api-v2.5/onboarding/list-all-merchants.md).

# List all merchants

## Get merchants

<mark style="color:blue;">`GET`</mark> `https://<Platform-host>/merchant`

Returns a list of accounts connected to your organization.

#### Query Parameters

<table><thead><tr><th width="116.8544921875">Name</th><th width="125.5244140625">Type</th><th>Description</th></tr></thead><tbody><tr><td>size</td><td>number</td><td>A limit on the number of objects to be returned. The limit can range between 1 and 100, and the default is 10.</td></tr><tr><td>page</td><td>number</td><td>Specify the page number that needs to be retrieved</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200 List of merchants in this account" %}

```json
{
    "data": [
        {
            "id": "d6399869-747c-4537-9c04-f81ce2a6c5eb",
            "name": "Merchant 1",
            "email": "email@example.com",
            "status": "editing",
            "created_at": "2022-03-07T16:40:24.213Z",
            "updated_at": "2022-03-07T16:40:24.213Z",
            "mid": "",
            "total_payment_volume": "0.00"
        },
        {
            "id": "03e675d2-ef81-4d1b-a236-cee7f6abee57",
            "name": "Merchant 2",
            "email": "email@example.com",
            "status": "editing",
            "created_at": "2022-03-07T16:35:21.460Z",
            "updated_at": "2022-03-07T16:35:21.460Z",
            "mid": "",
            "total_payment_volume": "0.00"
        },
        {
            "id": "d52d6547-b12e-43f1-a361-58c5f67226b5",
            "name": "Merchant 3",
            "email": "email@example.com",
            "status": "submitted_to_pe",
            "created_at": "2022-03-07T16:08:32.876Z",
            "updated_at": "2022-03-07T16:08:32.876Z",
            "mid": "",
            "total_payment_volume": "0.00"
        }
   ]
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Node.js" %}

```javascript

var config = {
  method: 'get',
  url: 'http://<Platform-host>/api/merchant',
  headers: { 
    'accept': 'application/json', 
    'Authorization': 'Basic {{YOUR_API_SECRET}}'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
```

{% endtab %}
{% endtabs %}