Reference

Lookup

Will a blue message to this handle arrive?

GET/v1/lookup?handle={handle}

What we know about reaching a handle on iMessage.

This is evidence, not a query to Apple. We cannot ask — so instead this reads what has already happened on your own numbers. An inbound iMessage is proof the handle answers; a send that left the Mac is the same proof from the other side. unknown means we have never tried, and is not a negative answer: routing to SMS on it would be routing on ignorance.

handle*

string

A phone number or Apple ID email.

curl -X GET https://api.missblue.dev/v1/lookup?handle=YOUR_HANDLE \
  -H "Authorization: Bearer $MISS_BLUE_KEY"

Response

{
  "handle": "+15555550100",
  "service": "imessage",
  "attempts": 3,
  "detail": "iMessage has worked with this handle before."
}

400No handle, an empty one, or one over 256 characters.

NextContactsNames for handles, shared by the project.