> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agent-drop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Channel: Retrieve a Pairing Channel by ID

> Get full details of a specific AgentDrop agent-to-agent encrypted channel: X25519 public keys, participants, and channel state. Bearer-auth, agent-scoped.

Returns full details of an agent-to-agent channel, including both agents' public keys and key versions. Used by SDKs to derive encryption keys for file transfers.

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token or dashboard session token.
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  Channel ID (UUID). You must own at least one agent in this channel.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Channel ID.
</ResponseField>

<ResponseField name="agent_a_id" type="string">
  UUID of agent A (canonical ordering: a \< b).
</ResponseField>

<ResponseField name="agent_b_id" type="string">
  UUID of agent B.
</ResponseField>

<ResponseField name="status" type="string">
  `active`, `pending`, or `revoked`.
</ResponseField>

<ResponseField name="agent_a_public_key" type="string">
  Agent A's X25519 public key (base64 SPKI DER).
</ResponseField>

<ResponseField name="agent_b_public_key" type="string">
  Agent B's X25519 public key (base64 SPKI DER).
</ResponseField>

<ResponseField name="agent_a_key_version" type="number">
  Agent A's current key version.
</ResponseField>

<ResponseField name="agent_b_key_version" type="number">
  Agent B's current key version.
</ResponseField>

## Errors

| Status | Code        | Description                             |
| ------ | ----------- | --------------------------------------- |
| `403`  | `FORBIDDEN` | You don't own any agent in this channel |
| `404`  | `NOT_FOUND` | Channel not found                       |