Get ticket messages

curl -X GET "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b"
headers = {
    "Authorization": "Bearer <token>"
}
params = {
    "limit": 50,
    "order": "asc"
}

response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

{
  "total": 2,
  "page": 1,
  "size": 50,
  "messages": [
    {
      "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "direction": "inbound",
      "message_type": "text",
      "body": "Hi, could you please confirm the demo time?",
      "status": "read",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": null,
      "reactions": null,
      "created_at": "2026-09-07T15:30:15Z",
      "updated_at": "2026-09-07T15:30:16Z"
    },
    {
      "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNDBB==",
      "direction": "outbound",
      "message_type": "text",
      "body": "Hello Sarah, your enterprise demonstration has been scheduled for tomorrow at 2 PM.",
      "status": "delivered",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "reactions": {
        "+14155552671": "👍"
      },
      "created_at": "2026-09-07T15:32:00Z",
      "updated_at": "2026-09-07T15:33:10Z"
    }
  ]
}

{
  "detail": "Inbox ticket not found"
}

GET

api

inbox

messages

{inbox_id}

curl -X GET "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b"
headers = {
    "Authorization": "Bearer <token>"
}
params = {
    "limit": 50,
    "order": "asc"
}

response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

{
  "total": 2,
  "page": 1,
  "size": 50,
  "messages": [
    {
      "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "direction": "inbound",
      "message_type": "text",
      "body": "Hi, could you please confirm the demo time?",
      "status": "read",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": null,
      "reactions": null,
      "created_at": "2026-09-07T15:30:15Z",
      "updated_at": "2026-09-07T15:30:16Z"
    },
    {
      "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNDBB==",
      "direction": "outbound",
      "message_type": "text",
      "body": "Hello Sarah, your enterprise demonstration has been scheduled for tomorrow at 2 PM.",
      "status": "delivered",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "reactions": {
        "+14155552671": "👍"
      },
      "created_at": "2026-09-07T15:32:00Z",
      "updated_at": "2026-09-07T15:33:10Z"
    }
  ]
}

{
  "detail": "Inbox ticket not found"
}

Retrieve the full message dialogue history for a given conversation ticket (inbox_id). Messages default to ascending chronological order (asc) suitable for chat rendering.

Authentication

This endpoint requires Bearer token authentication.

Authorization: Bearer <token>

Header	Type	Required	Description	Format
`Authorization`	`string`	Yes	Scoped organization API key or Bearer JWT token	`Bearer <token>`

Path Parameters

string

required

Bearer token for authentication. Format: Bearer <token>.

string

required

Unique UUID identifier of the inbox ticket whose message thread is being requested.

Query Parameters

integer

default:"50"

Maximum number of messages to retrieve (1 to 100).

integer

default:"0"

Pagination offset (minimum 0).

string

default:"asc"

Chronological ordering direction (asc or desc).

Response Fields

integer

Total number of messages in the ticket conversation thread.

integer

Calculated page index.

integer

Count of returned messages in current batch.

object[]

Ordered array of message entries.

Show MessageResponse Fields

string

UUID identifier of the message.

string

Parent inbox ticket UUID.

string

Meta WhatsApp message ID (wamid...).

string

inbound or outbound.

string

Message kind (text, image, document, audio, video).

string

Message text or media description.

string

State (sent, delivered, read, failed).

string

Streaming media download URL if file attached.

string

MIME content type of attached file.

object

Map of sender identifier to emoji reactions.

string

Message timestamp.

curl -X GET "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc" \
  -H "Authorization: Bearer <token>"

import requests

url = "https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b"
headers = {
    "Authorization": "Bearer <token>"
}
params = {
    "limit": 50,
    "order": "asc"
}

response = requests.get(url, headers=headers, params=params)
print(response.status_code)
print(response.json())

const response = await fetch("https://api.sayvy.ai/api/v1/inbox/messages/e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b?limit=50&order=asc", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();
console.log(data);

{
  "total": 2,
  "page": 1,
  "size": 50,
  "messages": [
    {
      "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "direction": "inbound",
      "message_type": "text",
      "body": "Hi, could you please confirm the demo time?",
      "status": "read",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": null,
      "reactions": null,
      "created_at": "2026-09-07T15:30:15Z",
      "updated_at": "2026-09-07T15:30:16Z"
    },
    {
      "id": "2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "inbox_id": "e4f3a2b1-9c8d-7e6f-5a4b-3c2d1e0f9a8b",
      "organization_id": "e0b973dc-13a8-4c9f-861a-03e5b4b1a8d9",
      "contact_id": "8a7c2b3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
      "whatsapp_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNDBB==",
      "direction": "outbound",
      "message_type": "text",
      "body": "Hello Sarah, your enterprise demonstration has been scheduled for tomorrow at 2 PM.",
      "status": "delivered",
      "media_url": null,
      "media_mime_type": null,
      "media_filename": null,
      "context_message_id": "wamid.HBgLMTE4OTAwOTk5MTE1FQIAERgSRjQ1Q0IzOTk3RTYwRTczMzNCAA==",
      "reactions": {
        "+14155552671": "👍"
      },
      "created_at": "2026-09-07T15:32:00Z",
      "updated_at": "2026-09-07T15:33:10Z"
    }
  ]
}

{
  "detail": "Inbox ticket not found"
}

Overview

Agents

Campaigns

Contacts

Templates

Knowledge Base

Webhooks

Call Logs

Quick Replies

Inbox

Get ticket messages

Authentication

Path Parameters

Query Parameters

Response Fields

​Authentication

​Path Parameters

​Query Parameters

​Response Fields

Authentication

Path Parameters

Query Parameters

Response Fields