---
title: "Get X account connect link status"
method: GET
path: "/api/v1/x/account-connection-links/{id}"
tags: ["X Accounts"]
---

# Get X account connect link status

`GET /api/v1/x/account-connection-links/{id}`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/x/account-connection-links/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - API key in cookie `__Host-xquik_session`

Reads what happened on a link. `status` reads `connected` once the person finishes, with `xUserId`, `xUsername` & `health`. It never holds the token. Takes a Full access API key holding `connectsXAccounts`, or a dashboard session.

## Path parameters

- `id` string, required

## Response `200`

The link's current state.

- XAccountConnectionLink: A link where a person connects an X account on Xquik's page.
  - `object` 'x_account_connection_link', required
  - `id` string, required
  - `purpose` 'connect' | 'reconnect', required
  - `status` 'pending' | 'connecting' | 'requires_email_code' | 'connected' | 'failed' | 'expired' | 'revoked', required: `failed` means 5 logins were refused, so make a new link. `revoked` means you revoked it, or the key that made it is paused, revoked, expired, no longer Full access or without `connectsXAccounts`. A link whose key resumes within its 30 minutes reads `pending` again.
  - `reference` string, nullable, required
  - `returnUrl` string, uri, nullable, required
  - `apiKeyId` string, nullable, required: The ID of the API key that made the link, or null when a dashboard session made it.
  - `accountId` string, nullable, required
  - `xUserId` string, nullable, required
  - `xUsername` string, nullable, required
  - `health` string, nullable, required
  - `failure` string, nullable, required: Why the last login didn't finish.
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `completedAt` string, date-time, nullable, required
  - `url` string, uri: Present only in the response that creates the link.

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit. Bad input costs nothing, since it's refused before any read.
- `401`: Unauthenticated
- `403`: An API key needs Full access & `connectsXAccounts` for connect links. Turn the permission on in a dashboard session at dashboard.xquik.com/api-keys. An OAuth token or MCP tool gets `session_required`, & a paused API key gets `api_key_paused`.
- `404`: Not found
- `429`: Too many requests right now. Each user gets 500 reads a second, 6,000 changes to Xquik resources a minute & 120 X actions a minute. X actions post, like, follow, message or edit through a connected X account. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `500`: Unexpected error.
- `default`: Unexpected error.

## Changes

- **2026-11-18** `fe9dc4f8a127`: 1 info
  - endpoint added
- **2026-11-18** `2284c0998114`: 1 breaking
  - api path removed without deprecation
- **2026-11-18** `a291f0b82030`: 1 info
  - endpoint added
- **2026-11-17** `e1e106c83615`: 1 breaking
  - api path removed without deprecation
- **2026-11-17** `d40150ef20b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/account-connection-links/:id/get.md)

---

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