---
title: "Get an Identity"
method: GET
path: "/entities/identity/{id}"
tags: ["Identity"]
---

# Get an Identity

`GET /entities/identity/{id}`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/entities/identity/{id}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/entities/identity/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get information about an Identity

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Response `200`

Get Identity

- object
  - `id` string, uuid: the object id, also found in the data object
  - `type` string: the object type, or array of objects
  - `data` object: the attributes for the object
    - `id` string: unique identity id
    - `platform_account_id` string, uuid
    - `business_id` string, uuid: associated business
    - `name` string: legal name
    - `title` string: job title
    - `email` string: email address
    - `phone` string: phone number
    - `dob_day` string: two-digit birth day
    - `dob_month` string: two-digit birth month
    - `dob_year` string: four-digit birth year (must be at least 18 years old)
    - `ssn_last4` string: last four digits of social security number (computed from identification_number)
    - `is_owner` boolean: if an identity owns 25% or more of the business, they are considered an owner
    - `ownership_percentage` integer: percentage of the business owned by this identity (0–100); only returned when is_owner is true
    - `metadata` object: any useful information you'd like to store alongside this identity
    - `address` AddressResponse
      - `id` string: unique address id
      - `platform_account_id` string: platform account that owns this address
      - `line1` string
      - `line2` string
      - `city` string
      - `state` string
      - `postal_code` string
      - `country` string
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `documents` Document[]
      - `id` string, uuid
      - `platform_account_id` string: platform account that owns this document
      - `description` string: description of the document, used for your reference
      - `file_name` string: file name of the document
      - `file_type` string: the file media type/extension of the file you are uploading. For example, text/plain, application/pdf, image/png
      - `document_type` 'articles_of_incorporation' | 'balance_sheet' | 'bank_statement' | 'birth_certificate' | 'business_registration' | 'citizenship_card' | 'driver_license' | 'foreign_passport' | 'government_id' | 'nexus_card' | 'passport' | 'profit_and_loss_statement' | 'resident_card' | 'sin_card' | 'ssn_card' | 'status_card' | 'tax_return' | 'voided_check' | 'other'
      - `business_id` string, uuid: the business id to associate with this document (one of business id or identity id is required)
      - `identity_id` string, uuid: the identity id to associate with this document (one of business id or identity id is required)
      - `presigned_url` string, url: url used to PUT or GET the document to our cloud provider. This is not returned via the list API
      - `metadata` object: any useful information you'd like to store alongside this document
      - `status` 'pending' | 'uploaded' | 'canceled'
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page_info` unknown

---

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