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

Response

Get iMessage conversation history for a thread

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1772568052124

api_version
string
required
Example:

"v2026.3.3"

object
string
required
Example:

"response"

data
object
required