Check iMessage availability

Check whether a phone number is reachable via iMessage before sending. Useful for routing logic or pre-qualifying contacts.

POST/api-check-imessage-availabilityBearer token

Request body

phonestringRequired

The phone number to check. Accepts many formats — we normalize to E.164.

Status codes

200: Phone checked successfully
400: Invalid phone number format
401: Missing or invalid API key
403: Trial account probing a destination that is not verified on the shared line
409: Trial account has no shared line provisioned
429: Rate limit exceeded
500: Internal server error

Request

curl -X POST https://api.tryprojectblue.com/api-check-imessage-availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+15551234567"
  }'

Response

{
  "normalizedPhone": "+15551234567",
  "isIMessageAvailable": true
}