# Contacts & channel lookup

> Look up a contact's details, opt-out state, and whether their phone supports blue bubbles.

## Get a contact

GET https://beam.aisync.link/v1/contacts/:phone
curlResponseCopy
```
curl "https://beam.aisync.link/v1/contacts/+15551234567" \
  -H "x-api-key: YOUR_WORKSPACE_KEY"
```

```
{
  "phone": "+15551234567",
  "first_name": "Sarah",
  "imessage_available": true,
  "opted_out": false,
  "pinned_number": "+15559876543",
  "created_at": "2026-08-21T19:14:59.000Z"
}
```

pinned_number is the line this contact will always hear from. opted_out: true means every send to them returns 403, permanently, unless they text back in.

## Check blue-bubble support

GET https://beam.aisync.link/v1/availability/:phone works for any number, even before the first message.
curlResponseCopy
```
curl "https://beam.aisync.link/v1/availability/+15551234567" \
  -H "x-api-key: YOUR_WORKSPACE_KEY"
```

```
{ "phone": "+15551234567", "imessage": true }
```

Use it to pre-segment a list (blue-bubble leads vs texting leads) before a campaign, or to badge contacts inside your own CRM. null means the check could not complete; try again later rather than assuming.