---
title: "Caller identity, current plan, full entitlement summary."
method: GET
path: "/v3/whoami"
tags: ["Account"]
---

# Caller identity, current plan, full entitlement summary.

`GET /v3/whoami`

## Request

- Base URL: `https://api.datocapital.com`
- URL: `https://api.datocapital.com/v3/whoami`
- Auth: HTTP bearer

## Response `200`

ok

- WhoAmI
  - `user_id` integer
  - `key_mode` 'live' | 'test'
  - `plan` object
    - `code` string
    - `name` string
    - `rank` integer
    - `limits` object
    - `features` object
    - `pricing` object: `monthly_cents` is the flat subscription fee. `per_request_cents` is the overage fee charged for each request beyond `limits.max_requests_per_month`; null means the plan is hard-capped at the monthly quota and returns 429 instead of metering the overage.
      - `currency` string
      - `monthly_cents` integer
      - `per_request_cents` integer, nullable
  - `entitlements` object
    - `fields` object[]
      - `entity` string
      - `field` string
      - `country` string
      - `min_plan` string
      - `accessible` boolean
    - `endpoints` object[]
      - `endpoint` string
      - `country` string
      - `min_plan` string
      - `accessible` boolean

## Other responses

- `401`: 401 — missing or invalid bearer token.

---

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