Check iMessage Availability (Single Address)
iMessage Availability
Check iMessage Availability (Single Address)
Check if a phone number or email is on iMessage — no saved lead required. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
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.
Single Address Check
Request
string
required
Phone number (E.164 format) or email address to check.Examples:
+14155551234, frank@example.comResponse
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.