---
title: "Read one granted account"
method: GET
path: "/v1/accounts/{account_id}"
tags: ["Accounts"]
---

# Read one granted account

`GET /v1/accounts/{account_id}`

## Request

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

Works with every API key. Returns the name, kind, region and status of one account that this credential can use, and the permissions of the credential in it. Other account IDs return 403.

## Path parameters

- `account_id` string, required

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required
    - `account` 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

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