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.
Partner-specific behavior
If you’re part of the Partner Program and supply a valid X-Annature-Partner header, this endpoint will return all accounts that belong to organisations your integration has created using the Register an account endpoint. This allows partners to retrieve accounts across every organisation they’ve provisioned — not just their own.
For example, if your platform registers 100 client organisations and each has 10 users, this endpoint will return all 1,000 accounts — not just those from your own organisation.
If the X-Annature-Partner header is not provided, this endpoint behaves normally and returns only the accounts within your organisation.
Parameters
Filter results by exact match on the account’s name property.
Filter results by exact match on the account’s email property.
Filter results by exact match on the account’s role. Valid values include: administrator, standard, read-only.
Filter results by exact match on the account’s active status. Accepts true or false.
Filter results by exact match on the group_id to list accounts within a specific account group.
Return accounts created before the specified ISO 8601 timestamp.
Return accounts created after the specified ISO 8601 timestamp.