---
title: "Retrieve a link"
method: GET
path: "/v1/links/{link_id}/"
tags: ["Account Links"]
---

# Retrieve a link

`GET /v1/links/{link_id}/`

## Response `200`

- Link — Link's properties
  - `id` string — Link ID
  - `access_token` string — Access token for data refresh. Returns masked value (e.g., `****************************7610`) unless filtered by `user_id`, in which case the full token is returned.
  - `created_at` string — Link creation timestamp (ISO 8601)
  - `updated_at` string — Link last update timestamp (ISO 8601)
  - `deleted_at` string, nullable — Link removal timestamp (ISO 8601)
  - `tracking_info` string, nullable — Optional tracking information provided by a partner
  - `status` string — Status of the last Task
  - `user_external_id` string, nullable — User external ID is information provided by a partner
  - `provider_id` string — Data provider ID
  - `provider` ProviderBase, nullable
    - `id` string, required — Data provider ID.
    - `name` string, required — Data provider name.
    - `logo_url` string, nullable — Data provider logo image.
  - `company_mapping` Employer, nullable
    - `id` string, nullable, required — Employer ID.
    - `name` string, required — Employer name.
    - `logo_url` string, nullable — Employer logo image.
  - `link_hash` string, nullable — Unique hash for the user credentials used to create the link
  - `allowed_products` string[] — List of all allowed products for this connection
  - `initial_product_type` 'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets' | 'credit' | 'education' | 'null', nullable — Initial product type
  - `data_source` 'payroll' | 'docs' | 'insurance' | 'financial_accounts' | 'tax' | 'scoring_attributes' | 'credit' | 'education' — Source of data: payroll - payroll provider parsing, docs - user uploaded documents, insurance - insurance data, financial_accounts - bank data, tax - tax documents, scoring_attributes - transactions scoring attributes report.
  - `is_suspicious` boolean — Flag to indicate if the data from the source is suspicious. E.g. fraud detected in uploaded documents or SSN of the user does not match with the data
  - `is_dds_available` boolean, nullable — This flag indicates if connected account supports deposit switching functionality. null - unknown, True - yes, False - No

## Other responses

- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden

---

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