---
title: "Read your connection claim's current status [read]"
method: GET
path: "/channels/connections/status"
tags: ["channels"]
---

# Read your connection claim's current status \[read\]

`GET /channels/connections/status`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/channels/connections/status`
- Auth: HTTP bearer

Look up a link-flow ceremony by its 32-character token, scoped to the authenticated owner and universe. Reconnecting an existing conversation can replace the pending connection ID; this returns the effective ID. It does not confirm downstream webhook processing. Responses are not cached. Normal API rate limits apply; back off on 429.

## Query parameters

- `token` string, required

## Response `200`

OK

- object
  - `status` 'pending' | 'connected' | 'expired' | 'disconnected', required
  - `connection_id` string, required
  - `platform` string, required
  - `metadata` object, required: The caller's original connection metadata
  - `expires_at` string, date-time

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - added the optional property `error/request_id` to the response with the `default` status

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/channels/connections/status/get.md)

---

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