Conversations

Read the conversations your integration created through the API.

List

GET/v1/conversations

Most recent first. limit from 1 to 100 (default 20).

curl "https://api.oryksa.com/v1/conversations?limit=20" -H "Authorization: Bearer oryk_live_YOUR_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "customer-4812",
      "messages": 6,
      "last_message": { "role": "assistant", "content": "Done! Saturday at 10am is booked." },
      "last_activity_at": "2026-09-24T09:41:07"
    }
  ]
}

One conversation

GET/v1/conversations/{id}

All the messages, in order.

curl https://api.oryksa.com/v1/conversations/customer-4812 -H "Authorization: Bearer oryk_live_YOUR_KEY"

{
  "object": "conversation",
  "id": "customer-4812",
  "messages": [
    { "role": "user", "content": "Can I book for Saturday at 10am?" },
    { "role": "assistant", "content": "Of course, Ana! Saturday at 10am is available. Shall I confirm?" }
  ]
}

For privacy, the API only returns conversations created through the API. WhatsApp and website chats stay in the owner's dashboard; to follow them in real time use the message.replied webhook.