---
title: "List all links"
method: GET
path: "/v1/links/"
tags: ["Account Links"]
---

# List all links

`GET /v1/links/`

## Query parameters

- `user_id` string
- `page` integer
- `page_size` integer

## Response `200`

- LinksListResponse — List all links
  - `count` integer, required — Number of Links to return
  - `next` string, nullable, required — Url to the next page
  - `previous` string, nullable, required — Url to the previous page
  - `results` Link[], required — List all links
    - `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/6542a8962887/schema)