---
title: "List accounts granted to this credential"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# List accounts granted to this credential

`GET /v1/accounts`

## Request

- Base URL: `https://api.revdoku.com`
- URL: `https://api.revdoku.com/v1/accounts`
- Auth: HTTP bearer

Works with every API key. Lists the account of this credential and the client accounts that an agency owner granted to it. Send an id from this list as account_id to act in that account.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Success

- object
  - `success` true, required
  - `data` AccountList, required
    - `accounts` AccountIdentity[], required
      - `id` string, required
      - `name` string, required: Account name, separate from the client person or business.
      - `account_kind` 'standard' | 'agency' | 'client', required
      - `client_name` string, nullable, required: Client person or business name, or null when unset.
      - `agency_account` object, nullable, required: Parent agency only when granted to this credential. Null does not make a client independent.
        - `id` string
        - `name` string
      - `region` string, nullable
      - `status` 'active' | 'read_only'
      - `permissions` object
        - `scope` 'mailbox_read' | 'mailbox_write' | 'mailbox_admin'
        - `mailbox_access` 'all' | 'selected'
        - `can_create_mailboxes` boolean
    - `default_account_id` string, nullable, required: Account used when a request does not send account_id.
    - `pagination` Pagination, required: One page of a list. Request the next page with cursor=next_cursor and the same filters. Cursors are opaque strings: do not build or decode them.
      - `limit` integer, required
      - `has_more` boolean, required: True when another page exists.
      - `next_cursor` string, nullable, required: Cursor for the next page; null on the last page. Email lists always return a cursor so that you can poll for new mail.

## Other responses

- `default`: Request failed. See error.code. Any 429 or 503 response with Retry-After (for example 503 EMAIL_LABELING_PENDING or 503 EMAIL_INDEX_BUILDING): wait that many seconds, then try the read again. 429 EMAIL_SEND_RATE_LIMITED has no Retry-After. Never retry EMAIL_LOOP_DETECTED.

---

[API](https://skmtc.dev/revdoku/apis/revdoku-api.md) · [All operations](https://skmtc.dev/revdoku/apis/revdoku-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdoku/apis/revdoku-api/revisions/3ff4e2540a8b?raw)