---
title: "Retrieve Link sessions for your user"
method: POST
path: "/credit/sessions/get"
tags: ["plaid"]
---

# Retrieve Link sessions for your user

`POST /credit/sessions/get`

This endpoint can be used for your end users after they complete the Link flow. This endpoint returns a list of Link sessions that your user completed, where each session includes the results from the Link flow.

These results include details about the Item that was created and some product related metadata (showing, for example, whether the user finished the bank income verification step).

## Request body

- CreditSessionsGetRequest — CreditSessionsGetRequest defines the request schema for `/credit/sessions/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.
  - `user_token` string, required — The user token associated with the user for which data is being requested. This field is used only by customers with pre-existing integrations that already use the `user_token` field. All other customers should use the `user_id` instead. For more details, see [New User APIs](https://plaid.com/docs/api/users/user-apis).
  - `user_id` string — A unique user identifier, created by `/user/create`. Integrations that began using `/user/create` after December 10, 2025 use this field to identify a user instead of the `user_token`. For more details, see [New User APIs](https://plaid.com/docs/api/users/user-apis).

## Response `200`

OK

- CreditSessionsGetResponse — CreditSessionsGetResponse defines the response schema for `/credit/sessions/get`
  - `sessions` CreditSession[] — A list of Link sessions for the user. Sessions will be sorted in reverse chronological order.
    - `link_session_id` string — The unique identifier associated with the Link session. This identifier matches the `link_session_id` returned in the onSuccess/onExit callbacks.
    - `session_start_time` string, date-time — The time when the Link session started
    - `results` CreditSessionResults — The set of results for a Link session.
      - `item_add_results` CreditSessionItemAddResult[] — The set of Item adds for the Link session.
        - `public_token` string — Returned once a user has successfully linked their Item.
        - `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.
        - `institution_id` string — The Plaid Institution ID associated with the Item.
      - `bank_income_results` CreditSessionBankIncomeResult[] — The set of bank income verifications for the Link session.
        - `status` 'APPROVED' | 'NO_DEPOSITS_FOUND' | 'USER_REPORTED_NO_INCOME' | 'STARTED' | 'INTERNAL_ERROR' — Status of the Bank Income Link session. `APPROVED`: User has approved and verified their income `NO_DEPOSITS_FOUND`: We attempted, but were unable to find any income in the connected account. `USER_REPORTED_NO_INCOME`: The user explicitly indicated that they don't receive income in the connected account. `STARTED`: The user began the bank income portion of the link flow. `INTERNAL_ERROR`: The user encountered an internal error.
        - `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.
        - `institution_id` string — The Plaid Institution ID associated with the Item.
      - `bank_employment_results` CreditSessionBankEmploymentResult[] — The set of bank employment verifications for the Link session.
        - `status` 'APPROVED' | 'NO_EMPLOYERS_FOUND' | 'EMPLOYER_NOT_LISTED' | 'STARTED' | 'INTERNAL_ERROR' — Status of the Bank Employment Link session. `APPROVED`: User has approved and verified their employment. `NO_EMPLOYERS_FOUND`: We attempted, but were unable to find any employment in the connected account. `EMPLOYER_NOT_LISTED`: The user explicitly indicated that they did not see their current or previous employer in the list of employer names found. `STARTED`: The user began the bank employment portion of the link flow. `INTERNAL_ERROR`: The user encountered an internal error.
        - `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.
        - `institution_id` string — The Plaid Institution ID associated with the Item.
      - `payroll_income_results` CreditSessionPayrollIncomeResult[] — The set of payroll income verifications for the Link session.
        - `num_paystubs_retrieved` integer — The number of paystubs retrieved from a payroll provider.
        - `num_w2s_retrieved` integer — The number of w2s retrieved from a payroll provider.
        - `institution_id` string — The Plaid Institution ID associated with the Item.
        - `institution_name` string — The Institution Name associated with the Item.
      - `document_income_results` CreditSessionDocumentIncomeResult, nullable — The details of a document income verification in Link
        - `num_paystubs_uploaded` integer, required — The number of paystubs uploaded by the user.
        - `num_w2s_uploaded` integer, required — The number of w2s uploaded by the user.
        - `num_bank_statements_uploaded` integer, required — The number of bank statements uploaded by the user.
        - `num_1099s_uploaded` integer, required — The number of 1099s uploaded by the user
        - `num_i20s_uploaded` integer, required — The number of I-20s uploaded by the user
    - `errors` CreditSessionError[] — The set of errors that occurred during the Link session.
      - `error_type` string — A broad categorization of the error.
      - `error_code` string — The particular error code.
      - `error_message` string — A developer-friendly representation of the error code.
      - `display_message` string, nullable — A user-friendly representation of the error code. `null` if the error is not related to user action.
  - `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)