# List Collection Accounts

The omnibus's collection accounts on a network — one per customer —, by account id.

## Overview

- Each with `accountId`, `role` (`collection`), `poolPosition` (`null`) and `addedAt`, in ascending order of `accountId`. The treasury and the pool are in the structure itself ([Get a Structure](https://docs.aureahub.com/docs/structures-get.md)).
- Up to `limit` (1–200, default 50); `nextAfter`, the last account id of the page, to send as `after` for the next — `null` on the last. A segregated network has none: `{ "accounts": [], "nextAfter": null }`.
- Any other query parameter answers `400` `STRUCTURE_REQUEST_INVALID`.
- For `owner`, `tenantadmin`, `non_signing_admin`, `signer`, `approver`, `editor`, `viewer` and `auditor`, on their own tenant, with an access token.

## Endpoint

### `GET /v1/structures/{network}/collection-accounts`

Authentication: bearer token required.

The omnibus's collection accounts on a network, by account id.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `network` | string | yes | `mainnet` or `testnet` |

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `after` | string (uuid) | no | The previous page's `nextAfter` |
| `limit` | integer | no | 1–200, default 50 |

**Responses**

`200` OK

```json
{
  "accounts": [
    {
      "accountId": "0a0698c3-18ff-4db3-bd66-f2e0ffbf0a29",
      "role": "collection",
      "poolPosition": null,
      "addedAt": "2026-10-13T09:25:18.733Z"
    },
    {
      "accountId": "3cb0a94e-6358-445d-99a2-021749a80e0a",
      "role": "collection",
      "poolPosition": null,
      "addedAt": "2026-10-13T09:25:18.733Z"
    }
  ],
  "nextAfter": "3cb0a94e-6358-445d-99a2-021749a80e0a"
}
```

`400` Invalid

```json
{
  "statusCode": 400,
  "error": "BadRequestError",
  "message": "Invalid request",
  "details": {
    "code": "STRUCTURE_REQUEST_INVALID",
    "errors": ["limit: Number must be less than or equal to 200"]
  }
}
```

**Example request**

```bash
curl "https://api.aureahub.com/v1/structures/mainnet/collection-accounts?limit=2" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#structures-collection-list