---
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` object
    - `account` Account
      - `id` integer
      - `email` string
      - `plan_identifier` string
      - `created_at` string, date-time — A date-time value formatted as ISO 8601.
      - `updated_at` string, date-time — A date-time value formatted as ISO 8601.
    - `user` User
      - `id` integer
      - `email` string
      - `created_at` string, date-time — A date-time value formatted as ISO 8601.
      - `updated_at` string, date-time — A date-time value formatted as ISO 8601.

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

- **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/2e2a96fa71fe/schema)