> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oyapasteaza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List dedicated accounts

> List active dedicated accounts for your merchant account.

Use this endpoint to retrieve active dedicated accounts for the authenticated merchant and API key environment.

## Endpoint

```http theme={null}
GET /v1/collections/dedicated-accounts
```

## Headers

```http theme={null}
Authorization: Bearer sk_test_xxx
```

## Example request

```bash theme={null}
curl https://api.oyapasteaza.com/v1/collections/dedicated-accounts \
  -H "Authorization: Bearer sk_test_xxx"
```

## Successful response

```json theme={null}
{
  "status": true,
  "message": "Dedicated accounts retrieved successfully.",
  "data": {
    "accounts": [
      {
        "externalReference": "CUS_001",
        "accountReference": "PZ_DCA_abc123",
        "accountNumber": "8023456789",
        "accountName": "LUCKY TECHNOLOGIES LTD",
        "bankName": "PASTEAZA TEST BANK",
        "status": "ACTIVE",
        "totalReceived": 500000,
        "metadata": {
          "customerId": "123"
        },
        "createdAt": "2026-06-27T10:00:00.000Z"
      }
    ]
  }
}
```

## Notes

* Disabled dedicated accounts are not returned as usable accounts.
* `totalReceived` is returned in kobo.
* Use `externalReference` to map each account to your internal customer, invoice, subscription, or record.

## Next step

<CardGroup cols={2}>
  <Card title="Retrieve dedicated account" icon="search" href="/collections/dedicated-accounts/retrieve-dedicated-account">
    Fetch one dedicated account by reference or account number.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/getting-started/webhooks">
    Handle payment notifications for dedicated account credits.
  </Card>
</CardGroup>