---
title: "Retrieve User Account"
method: POST
path: "/user_account/session/get"
tags: ["plaid"]
---

# Retrieve User Account

`POST /user_account/session/get`

This endpoint returns user permissioned account data, including identity and Item access tokens, for use with [Plaid Layer](https://plaid.com/docs/layer). Note that end users are permitted to edit the prefilled identity data in the Link flow before sharing it with you; you should treat any identity data returned by this endpoint as user-submitted, unverified data. For a verification layer, you can add [Identity Verification](https://plaid.com/docs/identity-verification/) to your flow, or check the submitted identity data against bank account data from linked accounts using [Identity Match](https://plaid.com/docs/identity/#identity-match).

## Request body

- UserAccountSessionGetRequest — UserAccountSessionGetRequest defines the request schema for `/user_account/session/get`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `public_token` string, required — The public token generated by the end user Layer session.

## Response `200`

success

- UserAccountSessionGetResponse — UserAccountSessionGetResponse defines the response schema for `/user_account/session/get`
  - `identity` UserAccountIdentity, nullable, required — The identity data permissioned by the end user during the authorization flow.
    - `name` UserAccountIdentityName, nullable — The user's first name and last name.
      - `first_name` string
      - `last_name` string
    - `address` UserAccountIdentityAddress, nullable — The user's address.
      - `city` string, nullable — The full city name
      - `region` string, nullable — The region or state. Example: `"NC"`
      - `street` string, nullable — The full street address Example: `"564 Main Street, APT 15"`
      - `street2` string, nullable — The second line street address
      - `postal_code` string, nullable — The postal code. In API versions 2018-05-22 and earlier, this field is called `zip`.
      - `country` string, nullable — The ISO 3166-1 alpha-2 country code
    - `phone_number` string — The user's phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format
    - `email` string, nullable — The user's email address. Note: email is currently not returned.
    - `date_of_birth` string, nullable — The user's date of birth.
    - `ssn` string, nullable — The user's Social Security number.
    - `ssn_last_4` string, nullable — The last 4 digits of the user's Social Security number.
  - `items` UserAccountItem[], required
    - `item_id` string — The Plaid Item ID. The `item_id` is always unique; linking the same account at the same institution twice will result in two Items with different `item_id` values. Like all Plaid identifiers, the `item_id` is case-sensitive.
    - `access_token` string — The access token associated with the Item for which data is being requested.
  - `identity_edit_history` UserAccountIdentityEditHistory, nullable — Statistics tracking the number of edits made to identity fields over various time periods.
    - `name` UserAccountIdentityEditCounts — Edit counts over various time periods.
      - `edits_current` integer — Number of edits in the current session
      - `edits_1d` integer — Number of edits in the last 1 day
      - `edits_30d` integer — Number of edits in the last 30 days
      - `edits_365d` integer — Number of edits in the last 365 days
      - `edits_all_time` integer — Total number of edits
    - `address` UserAccountIdentityEditCounts — Edit counts over various time periods.
      - `edits_current` integer — Number of edits in the current session
      - `edits_1d` integer — Number of edits in the last 1 day
      - `edits_30d` integer — Number of edits in the last 30 days
      - `edits_365d` integer — Number of edits in the last 365 days
      - `edits_all_time` integer — Total number of edits
    - `email` UserAccountIdentityEditCounts — Edit counts over various time periods.
      - `edits_current` integer — Number of edits in the current session
      - `edits_1d` integer — Number of edits in the last 1 day
      - `edits_30d` integer — Number of edits in the last 30 days
      - `edits_365d` integer — Number of edits in the last 365 days
      - `edits_all_time` integer — Total number of edits
    - `date_of_birth` UserAccountIdentityEditCounts — Edit counts over various time periods.
      - `edits_current` integer — Number of edits in the current session
      - `edits_1d` integer — Number of edits in the last 1 day
      - `edits_30d` integer — Number of edits in the last 30 days
      - `edits_365d` integer — Number of edits in the last 365 days
      - `edits_all_time` integer — Total number of edits
    - `official_document` UserAccountIdentityOfficialDocument, nullable — Official identity document edit statistics.
      - `ssn` UserAccountIdentityEditCounts — Edit counts over various time periods.
        - `edits_current` integer — Number of edits in the current session
        - `edits_1d` integer — Number of edits in the last 1 day
        - `edits_30d` integer — Number of edits in the last 30 days
        - `edits_365d` integer — Number of edits in the last 365 days
        - `edits_all_time` integer — Total number of edits
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)