Skip to main content
GET
Check iMessage Availability (Single Address)
The simplest way to check if a phone or email has iMessage. Just pass the address as a query parameter. No lead ID, no saved contact required.
Don’t know which endpoint to use? Start here. This is the one you want for a quick, one-off check.

Single Address Check

Request

string
required
Phone number (E.164 format) or email address to check.Examples: +14155551234, frank@example.com

Response

boolean
Whether the API call completed without errors.
boolean
true if the address is registered on iMessage right now.
string
The address that was checked (echoed back).

Not available


Single Address Check (POST)

POST /api/check-availability You can also POST a single address instead of using the GET query param.

Request

string
A single phone number or email to check. Mutually exclusive with addresses.

Response


Batch Check (Multiple Addresses)

POST /api/check-availability Check up to 100 addresses in a single request. Each address is checked sequentially (3s gap per device).

Request

string[]
Array of phone numbers or emails to check. Max 100 per request. Mutually exclusive with address.

Response


Rate Limits


Error Codes