---
title: "Whoami"
method: GET
path: "/whoami"
tags: ["identity"]
---

# Whoami

`GET /whoami`

Retrieves the details about the current authenticated entity used to access the API.

## Response `200`

Successful response with user or account.

- object
  - `data` union, required
    - object
      - `account` Account, required
        - `id` integer, required
        - `email` string, required
        - `plan_identifier` string, required
        - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
        - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.
      - `user` object, nullable, required
    - object
      - `user` User, required
        - `id` integer, required
        - `email` string, required
        - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
        - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.
      - `account` object, nullable, required

## Other responses

- `401` — The authentication credentials are invalid.
- `429` — You exceeded the allowed number of requests per hour and your request has temporarily been throttled.
- `default` — An error occurred

## Changes

- **2025-07-30** (v2) `2a675399e169` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `data` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `data` response property `oneOf` list for the response status `200`
- **2025-07-11** (v2) `9e13cb9217f9` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `data` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `data` response property `oneOf` list for the response status `200`
- **2025-07-11** (v2) `06780be0ef17` — 2 breaking, 2 warning, 4 info
  - added `subschema #1, subschema #2` to the `data` response property `oneOf` list for the response status `200`
  - the `data` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data/account` from the response with the `200` status
  - removed the optional property `data/user` from the response with the `200` status
  - …4 more
- **2023-07-18** (v2) `c8591dcf8c29` — 5 breaking, 3 info
  - the response property `data` became optional for the status `200`
  - the response property `message` became optional for the status `401`
  - the response property `message` became optional for the status `429`
  - the response property `message` became optional for the status `default`
  - …4 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/whoami/get.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)