Skip to main content
GET
cURL
Technically, iCloud emails are supported… but their behavior is unpredictable.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

to
string
required

Recipient's iMessage address. Must be in E.164 format.

Example:

"+1234567890"

from
string
required

Leased iMessage number that has been used to send messages to the recipient. Must be in E.164 format.

Example:

"+15555555555"

limit
string
default:20

Limit of how many messages to return, default is 20. Should never exceed 200.

Example:

20

Query Parameters

tracking
string | null
default:false

Set to true to include detailed internal tracking information for the request. Defaults to false.

Example:

"false"

Response

Get iMessage conversation history for a thread

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1785698220563

api_version
string
required
Example:

"v2026.8.2"

object
string
required
Example:

"response"

data
object
required