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

# List all accounts (paged)

Returns a paginated list of accounts associated with your organisation. Results are returned in descending order of creation date, with the most recently created accounts appearing first. If multiple accounts share the same timestamp, they are secondarily ordered by `id` to ensure consistent pagination.

Use this endpoint to manage your organisation’s team structure, audit user accounts, or retrieve subsets of accounts based on role, group membership, or other attributes. Filtering works exactly as it does in the original [List all accounts](/api-reference/accounts/list-all-accounts) endpoint, with the addition of cursor-based pagination.

To retrieve the next page of results, pass the `cursor` value from the previous response into your next request. The `has_more` property will indicate whether additional results are available.

### Partner-specific behavior

If you’re part of the [Partner Program](/api-reference/partner-program) and supply a valid `X-Annature-Partner` header, this endpoint will return all accounts provisioned by your integration — across every organisation you've registered using the [Register an account](/api-reference/accounts/register-account) endpoint. It excludes your own internal users.

If the `X-Annature-Partner` header is **not** provided, the endpoint returns only the accounts within your own organisation.

## Parameters

<ParamField path="name" type="string">
  Filter results by exact match on the account's `name` property.
</ParamField>

<ParamField path="email" type="string">
  Filter results by exact match on the account's `email` property.
</ParamField>

<ParamField path="role" type="string">
  Filter results by exact match on the account's `role`. Valid values include: `administrator`, `standard`, `read-only`.
</ParamField>

<ParamField path="active" type="string">
  Filter results by exact match on the account's `active` status. Accepts `true` or `false`.
</ParamField>

<ParamField path="group_id" type="string">
  Filter results by exact match on the `group_id` to list accounts within a specific account group.
</ParamField>

<ParamField path="created_before" type="string">
  Return accounts created before the specified ISO 8601 timestamp.
</ParamField>

<ParamField path="created_after" type="string">
  Return accounts created after the specified ISO 8601 timestamp.
</ParamField>

<ParamField path="cursor" type="string">
  Pagination cursor returned from a previous request. Use this to fetch the next page of results.
</ParamField>

<RequestExample>
  ```bash Endpoint theme={null}
  GET /v2/accounts
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "accounts": [
      {
        "id": "c64ce66b70b21c03bfd5dfa0ab14b730",
        "name": "Ted Annature",
        "email": "ted@annature.com.au",
        "number": "1300 000 000",
        "timezone": "+10:00",
        "role": "administrator",
        "active": true,
        "group_id": "a5a885caee6286a54ad7bbd4ab5400e9",
        "organisation_id": "62e9a87c6ed1444d9d228c4a0374017d",
        "created": "2019-12-17T05:30:00Z",
        "verified": "2019-12-17T05:30:00Z"
      }
    ],
    "cursor": "eyJpZCI6ImYxMjMiLCJjcmVhdGVkIjoiMjAyNS0wNy0wOVQwODozMDowMFoifQ==",
    "has_more": true
  }
  ```
</ResponseExample>