---
title: "List X account connect links"
method: GET
path: "/api/v1/x/account-connection-links"
tags: ["X Accounts"]
---

# List X account connect links

`GET /api/v1/x/account-connection-links`

## Request

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

Lists your connect links, newest first, with `apiKeyId` naming the API key that made each one, or null for a dashboard session. Use it to find and revoke the links a leaked key made. It never holds a token. Takes a Full access API key holding `connectsXAccounts`, or a dashboard session.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Your connect links, newest first.

- object
  - `links` XAccountConnectionLink[], required
    - `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.
  - `hasMore` boolean, required
  - `nextCursor` string

## 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`.
- `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/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)
