Skip to main content
GET
/
contacts
/
{id}
/
messages
Get contact messages
curl --request GET \
  --url https://api.arnio.co/api/v1/contacts/{id}/messages \
  --header 'X-API-Key: <api-key>'
{
  "messages": [
    {
      "id": "<string>",
      "from": "<string>",
      "to": "<string>",
      "direction": "<string>",
      "message": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "attachments": [
        {}
      ],
      "service": "<string>",
      "status": {
        "read": true,
        "delivered": true
      }
    }
  ]
}
Fetch all messages for a specific contact by their ID.

​
Parameters

NameInTypeRequiredDescription
idpathstring✅The ID of the contact
pagequeryinteger❌Page number for pagination (default: 1)
limitqueryinteger❌Number of messages per page (default: 20)

​
Responses

  • 200: Messages retrieved successfully. Returns an array of message objects:
{
  "messages": [
    {
      "id": "GUID",
      "from": "+15551234567",
      "to": "+15557654321",
      "direction": "outbound",
      "message": "Hello",
      "timestamp": "2025-08-28T12:34:56Z",
      "attachments": [],
      "service": "iMessage",
      "status": {
        "read": false,
        "delivered": true
      }
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Provide your API key

Path Parameters

​
id
string
required

ID of the contact

Query Parameters

​
page
integer
default:1

Page number for pagination

​
limit
integer
default:20

Number of messages per page

Response

200 - application/json

Messages retrieved

​
messages
object[]