## List linked channels

**get** `/v1/channels`

Lists the channel identities linked to your brand. An empty list means nothing is linked yet.

### Returns

- `channels: array of ChannelBinding`

  Always an array; `[]` when nothing is linked yet, never null.

  - `business_id: string`

    The linked business id: a UUID issued at business registration.

  - `channel: "amb"`

    The messaging channel. `amb` is the only channel this API serves today.

    - `"amb"`

  - `created_at: string`

  - `entry_point_url: string`

    The Messages entry deep link for this binding
    (`https://bcrw.apple.com/urn:biz:<business_id>`); open it from an
    approved tester device to start a chat with the business and verify the
    link end to end. DERIVED from `business_id`, not stored: the URL format
    is platform knowledge, served here so no client composes it by hand.

  - `origin: "seed" or "connect" or "control"`

    Where the link came from: `connect` is a self-service link (the Connect
    landing page, or `POST /v1/channels`: the same self-service path over
    this API), `seed` is boot configuration, `control` was provisioned by
    Linq. Provenance only; all three behave identically.

    - `"seed"`

    - `"connect"`

    - `"control"`

### Example

```http
curl https://messages.api.linqapp.com/v1/channels \
    -H "Authorization: Bearer $LINQ_AMB_API_KEY"
```

#### Response

```json
{
  "channels": [
    {
      "channel": "amb",
      "business_id": "a884eddf-b0ad-4be4-9c0e-071531638768",
      "origin": "connect",
      "entry_point_url": "https://bcrw.apple.com/urn:biz:a884eddf-b0ad-4be4-9c0e-071531638768",
      "created_at": "2026-08-01T12:00:00Z"
    }
  ]
}
```