---
title: "Get auth link status"
method: GET
path: "/v1/connections/auth-links/{auth_link_id}/status"
tags: ["Connections"]
---

# Get auth link status

`GET /v1/connections/auth-links/{auth_link_id}/status`

## Request

- Base URL: `https://api.markifact.com`
- URL: `https://api.markifact.com/v1/connections/auth-links/{auth_link_id}/status`
- Auth: HTTP bearer

Check whether an auth link is pending, expired, or connected.

## Path parameters

- `auth_link_id` string, required

## Response `200`

Auth link status returned.

- AuthLinkStatus
  - `id` string, required
  - `status` 'pending' | 'connected' | 'expired', required
  - `connection_type` string, required
  - `connection_id` string, nullable
  - `external_id` string, nullable
  - `expires_at` integer, required
  - `consumed_at` integer, nullable
  - `created_at` integer, required
  - `updated_at` integer, required
  - `connections` Connection[], required
    - `id` string, nullable, required: Public Markifact connection ID.
    - `type` string, required: Connection type.
    - `display_name` string, nullable
    - `external_id` string, nullable
    - `is_private` boolean, required
    - `created_at` integer, nullable
    - `updated_at` integer, nullable

## Other responses

- `404`: Auth link not found.

---

[API](https://skmtc.dev/markifact/apis/markifact-api.md) · [All operations](https://skmtc.dev/markifact/apis/markifact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/markifact/apis/markifact-api/revisions/24033d2ceea4?raw)