---
title: "Get Identity"
method: GET
path: "/accounts/{account_id}/identity"
tags: ["Income and Employment"]
---

# Get Identity

`GET /accounts/{account_id}/identity`

## Request

- Base URL: `https://api.getpinwheel.com/v1`
- URL: `https://api.getpinwheel.com/v1/accounts/{account_id}/identity`
- Auth: API key in header `X-API-SECRET`
- TypeScript: <https://skmtc.dev/getpinwheel/apis/pinwheel/docs/accounts/:account_id/identity/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the current identity information of the account owner.

## Path parameters

- `account_id` string, uuid, required: UUID of the payroll account.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Response `200`

OK

- object
  - `data` IdentityObjResponse, required
    - `id` string, uuid, required: Unique identifier for the object.
    - `created_at` string, date-time, required: ISO 8601 timestamp of created time.
    - `updated_at` string, date-time, required: ISO 8601 timestamp of the last update to this object.
    - `account_id` string, uuid, required: Unique identifier for the object.
    - `full_name` string, required: The full name of the employee.
    - `emails` string[]: The emails associated with the employee.
    - `date_of_birth` string, date: The date the employee was born.
    - `last_four_ssn` string: The last four digits of the employee's social security number (SSN).
    - `address` AddressGetResponseItem
      - `raw` string, required: The raw address.
      - `line1` string: The first line of the address.
      - `line2` string: The second line of the address.
      - `city` string: The city of the address.
      - `state` string: The state of the address.
      - `postal_code` string: The postal code of the address.
      - `country` 'US': The country of the address.
    - `phone_numbers` PhoneNumberGetResponseItem[]: The phone numbers of the employee.
      - `value` string, required: The E.164 formatted phone number.
      - `type` 'home' | 'work' | 'mobile': home, mobile, work, etc.
  - `meta` RefreshableMeta, required
    - `refreshed_at` string, date-time: ISO 8601 timestamp of the most recent refresh of this data.

---

[API](https://skmtc.dev/getpinwheel/apis/pinwheel.md) - [All operations](https://skmtc.dev/getpinwheel/apis/pinwheel/llms.txt) - [OpenAPI document](https://skmtc.dev/getpinwheel/apis/pinwheel/revisions/4543563d0f72?raw)