> ## 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

Returns a list of accounts associated with your organisation. Results are returned in descending order of creation date, with the most recently created accounts appearing first.

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. Results can be narrowed using exact-match filters.

The response is limited to a maximum of 1,000 results.

### 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>

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

<ResponseExample>
  ```json theme={null}
  [{
    "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"
  }]
  ```
</ResponseExample>