Get Conversation History

cURL

curl --request GET \
  --url https://api.contiguity.com/conversations/history/imessage/{to}/{from}/{limit} \
  --header 'Authorization: Bearer <token>'

{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1761968887641,
  "api_version": "v2025.10.31",
  "object": "response",
  "data": {
    "conversation": [
      {
        "to": "+1234567890",
        "from": "+15555555555",
        "message": "Hello, world!",
        "timestamp": 1757550304652,
        "read": 1757550304652,
        "delivery": {
          "status": "delivered",
          "delayed": false,
          "timestamp": 1757550304652
        },
        "risk": {
          "auto_reported_as_spam": true,
          "marked_as_spam": false
        },
        "attachments": []
      }
    ],
    "reactions": [
      {
        "reaction": "love",
        "on": "Hello, world!",
        "timestamp": 1757550304652,
        "action": "added",
        "from": "+15555555555"
      }
    ],
    "chat": {
      "filtered": false,
      "chat_marked_as_spam": false,
      "limit": 20,
      "total": 382,
      "count": 20
    }
  }
}

GET

history

imessage

{to}

{from}

{limit}

cURL

curl --request GET \
  --url https://api.contiguity.com/conversations/history/imessage/{to}/{from}/{limit} \
  --header 'Authorization: Bearer <token>'

{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1761968887641,
  "api_version": "v2025.10.31",
  "object": "response",
  "data": {
    "conversation": [
      {
        "to": "+1234567890",
        "from": "+15555555555",
        "message": "Hello, world!",
        "timestamp": 1757550304652,
        "read": 1757550304652,
        "delivery": {
          "status": "delivered",
          "delayed": false,
          "timestamp": 1757550304652
        },
        "risk": {
          "auto_reported_as_spam": true,
          "marked_as_spam": false
        },
        "attachments": []
      }
    ],
    "reactions": [
      {
        "reaction": "love",
        "on": "Hello, world!",
        "timestamp": 1757550304652,
        "action": "added",
        "from": "+15555555555"
      }
    ],
    "chat": {
      "filtered": false,
      "chat_marked_as_spam": false,
      "limit": 20,
      "total": 382,
      "count": 20
    }
  }
}

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

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

string

required

Example:

"req_xxxxxxxxxxxxxxxx"

timestamp

number

required

Example:

1761968887641

api_version

string

required

Example:

"v2025.10.31"

object

string

required

Example:

"response"

data

object

required

Show child attributes

data.conversation

object[]

required

Show child attributes

data.conversation.to

string

required

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

Example:

"+1234567890"

data.conversation.from

string

required

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

Example:

"+15555555555"

data.conversation.message

string

required

Message content.

Example:

"Hello, world!"

data.conversation.timestamp

number

required

Timestamp (when the message was sent).

Example:

1757550304652

data.conversation.read

number

required

Timestamp (when the message was read).

Example:

1757550304652

data.conversation.delivery

object

required

Show child attributes

data.conversation.delivery.status

string

required

Status of the delivery (delivered, failed, delayed).

Example:

"delivered"

data.conversation.delivery.delayed

boolean

required

Whether the message was delayed.

Example:

false

data.conversation.delivery.timestamp

number

required

Timestamp (when the message was delivered).

Example:

1757550304652

data.conversation.risk

object

required

Show child attributes

data.conversation.risk.auto_reported_as_spam

boolean

required

Whether the message was automatically labeled as spam by Apple.

Example:

true

data.conversation.risk.marked_as_spam

boolean

required

Whether the message was marked as spam by the user.

Example:

false

data.conversation.attachments

string[]

required

URLs of the attachments.

Example:

[]

data.reactions

object[]

required

Show child attributes

data.reactions.reaction

string

required

Reaction emoji.

Example:

"love"

data.reactions.on

string

required

Message content.

Example:

"Hello, world!"

data.reactions.timestamp

number

required

Timestamp of the reaction.

Example:

1757550304652

data.reactions.action

string

required

Action of the reaction.

Example:

"added"

data.reactions.from

string

required

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

Example:

"+15555555555"

data.chat

object

required

Show child attributes

data.chat.filtered

boolean

required

Whether the conversation was filtered by Apple.

Example:

false

data.chat.chat_marked_as_spam

boolean

required

Whether the chat was automatically labeled as spam by Apple.

Example:

false

data.chat.limit

number

required

Message return limit.

Example:

20

data.chat.total

number

required

Total number of messages in the conversation.

Example:

382

data.chat.count

number

required

Number of messages returned.

Example:

20

Mark Read Send

⌘I

Getting Started

Text

Email

OTP

Identity

iMessage

WhatsApp

Lease

Get Conversation History

Authorizations

Path Parameters

Response