v39

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-017897360.9 KB

Authorization Tokens

List Authorization Tokens

List Authorization Tokens for a Donor Account. Token codes are never returned by this endpoint — only the metadata is returned.

get/v1/donor_accounts/{id}/authorization_tokens

Path parameters

idstring required

The unique id of the Donor Account

Query parameters

status'pending' | 'verified' | 'revoked' | 'expired'

The status of a Donor Authorization Token.

pending: The token has been issued but not yet verified.
verified: The token has been verified and can no longer be used.
revoked: The token was explicitly revoked before being verified.
expired: The token's expires_at has passed and it can no longer be verified.

Example:pending

Filter tokens by status.

page_limitinteger

the number of results to return; defaults to 10, max is 100

page_tokenstring

A cursor for paginating; pass the value from next_page_token of the previous response.

Response

The response for DonorAccounts.listAuthorizationTokens

next_page_tokenstring nullable

A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the page_token). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

Example response

{
  "results": [
    {
      "id": "auth_token_01jpjenf5q6cawy43yxfcrxhct",
      "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct",
      "status": "pending",
      "code": "DAFP-7K3X-9M4Q",
      "created_at": "2026-04-01T12:00:00Z",
      "expires_at": "2026-05-01T12:00:00Z",
      "verified_at": "2026-04-02T18:30:00Z",
      "revoked_at": "2026-04-02T18:30:00Z"
    }
  ]
}