# Identity Retrieval

Enables retrieval of detailed information about a specific identity using the unique identityReference.

Endpoint: GET /eapi/v0/identities/{identity_reference}
Version: 0 BETA
Security: HMACAuth

## Path parameters:

  - `identity_reference` (string, required)
    The identity reference to retrieve data for.
    Example: "/identities/c-13344"

## Query parameters:

  - `email` (string)
    Optional email address to assist with identity matching.
    Example: "user@example.com"

## Response 200 fields (application/json):

  - `identifyReference` (string, required)
    ASCII letters, digits, and hyphen only, A unique customer identifier provided by you. This field is required and must be unique for each customer. Please ensure you consistently reuse the same identityReference for repeat interactions with the same customer, allowing us to reliably recognize and associate their identity.
    Example: "c-13344"

  - `account` (object, required)

  - `account.blocked` (boolean, required)
    The account status

  - `account.exists` (boolean, required)
    Indicated wether the account exists
    Example: true

  - `account.createdAt` (string, required)
    The UTC date time of the identity.
    Example: "2023-06-05T19:53:08.320Z"

## Response 400 fields (application/json):

  - `message` (string)
    Example: "Bad Request"

  - `status` (integer)
    Example: 400

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"

## Response 401 fields (application/json):

  - `message` (string)
    Example: "Unauthenticated."

  - `status` (integer)
    Example: 401

## Response 404 fields (application/json):

  - `message` (string)
    Example: "Not Found"

  - `status` (integer)
    Example: 404

## Response 422 fields (application/json):

  - `message` (string)
    Example: "The given data was invalid."

  - `errors` (object)

  - `status` (integer)
    Example: 422

## Response 429 fields (application/json):

  - `message` (string)
    Example: "Too Many Requests. Please try again later."

  - `status` (integer)
    Example: 429

## Response 500 fields (application/json):

  - `message` (string)
    Example: "Server Error"

  - `status` (integer)
    Example: 500

  - `traceId` (string)
    Idempotency key for the error
    Example: "2b6fc5d0-57e4-4b5a-9e3c-6cfbb6d8023f"