Skip to main content
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 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 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

​
string
Filter results by exact match on the account’s name property.
​
string
Filter results by exact match on the account’s email property.
​
string
Filter results by exact match on the account’s role. Valid values include: administrator, standard, read-only.
​
string
Filter results by exact match on the account’s active status. Accepts true or false.
​
string
Filter results by exact match on the group_id to list accounts within a specific account group.
​
string
Return accounts created before the specified ISO 8601 timestamp.
​
string
Return accounts created after the specified ISO 8601 timestamp.