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
    }
  }
}
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