Skip to main content
GET
/
history
/
text
/
{to}
/
{from}
/
{limit}
cURL
curl --request GET \
  --url https://api.contiguity.com/conversations/history/text/{to}/{from}/{limit} \
  --header 'Authorization: Bearer <token>'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1772568052124,
  "api_version": "v2026.3.3",
  "object": "response",
  "data": {
    "conversation": [
      {
        "to": "+1234567890",
        "from": "+15555555555",
        "message": "Hello, world!",
        "timestamp": 1757550304652,
        "delivery": {
          "status": "delivered",
          "delayed": false,
          "timestamp": 1757550304652
        },
        "attachments": []
      }
    ],
    "reactions": [
      {
        "reaction": "love",
        "on": "Hello, world!",
        "timestamp": 1757550304652,
        "action": "added",
        "from": "+15555555555"
      }
    ],
    "chat": {
      "limit": 20,
      "total": 20,
      "count": 20
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.contiguity.com/llms.txt

Use this file to discover all available pages before exploring further.

Contiguity has no way to query messages from carriers. Contiguity can only return messages we have processed and stored.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
to
string
required

Other party's phone number. Must be in E.164 format.

Example:

"+1234567890"

​
from
string
required

Your leased number used in this thread. 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 SMS/MMS conversation history for a thread. Queries your sent messages and incoming webhook events only.

​
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