---
title: "List WhatsApp connect links"
method: GET
path: "/api/v1/channels/connect-sessions"
tags: ["channels"]
---

# List WhatsApp connect links

`GET /api/v1/channels/connect-sessions`

## Request

- Base URL: `https://app.blueticked.com`
- URL: `https://app.blueticked.com/api/v1/channels/connect-sessions`
- Auth: HTTP bearer

The connect links you have sent, newest first, with the status of each.

status is one of active, used, expired or revoked. It is derived when you read, so a link never reports active here while the page already refuses it.

The token is never returned, only token_prefix, which is enough to identify a link in a support conversation and not enough to use it.

A key narrowed to specific businesses sees only those businesses' links.

limit defaults to 25, maximum 100.

## Query parameters

- `limit` integer

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, uuid, required
    - `status` 'active' | 'used' | 'expired' | 'revoked', required
    - `token_prefix` string, required
    - `business_id` string, uuid, nullable, required
    - `reference` string, nullable, required
    - `redirect_url` string, nullable, required
    - `expires_at` string, date-time, required
    - `used_at` string, date-time, nullable, required
    - `revoked_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
  - `request_id` string, required

## Other responses

- `400`: Validation failed
- `401`: Unauthorized: missing or invalid API key
- `402`: Insufficient wallet balance
- `403`: Forbidden: scope, plan limit, or suspension
- `404`: Not found
- `409`: Conflict (idempotency-key reuse or resource in use)
- `422`: Understood but refused: the request is well-formed, the action is not permitted for this resource
- `429`: Rate limited
- `500`: Internal error
- `502`: An upstream provider refused or failed the request
- `503`: Channel or send queue unavailable

---

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