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

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

Response

success
boolean
Whether the API call completed without errors.
available
boolean
true if the address is registered on iMessage right now.
address
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

address
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

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

Response


Rate Limits


Error Codes