---
title: "List external authentication links"
method: GET
path: "/api/v3/datasources/{datasource_name}/external-auth-links"
tags: ["Data source connections"]
---

# List external authentication links

`GET /api/v3/datasources/{datasource_name}/external-auth-links`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/datasources/{datasource_name}/external-auth-links`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `dts_session_id`
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/datasources/:datasource_name/external-auth-links/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the external authentication links generated for this data source in the current
workspace, newest first. Each link carries its current status: `not_used`, `used`,
`expired`, or `revoked_manually`. An unknown `datasource_name` yields an empty list.

## Path parameters

- `datasource_name` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

External authentication links

- PaginatedExternalAuthLinkList
  - `count` integer: Number of external authentication links
  - `next` string: URL to the next page
  - `previous` string: URL to the previous page
  - `results` ExternalAuthLinkListItem[]
    - `id` integer: External authentication link ID
    - `data_source` string: Data source name
    - `data_source_title` string: Human-readable data source title
    - `status` 'not_used' | 'used' | 'expired' | 'revoked_manually': Current status of the link
    - `created_at` string, date-time: When the link was generated
    - `sent_to_email` string, email: Email of the external user the link was generated for
    - `sender` string, email: Email of the user who generated the link
    - `revoked_at` string, date-time, nullable: When the link was revoked, if it was
    - `revoked_by` string: Email of the user who revoked the link; empty string if not revoked

## Other responses

- `401`: Forbidden

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)