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

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.

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.