Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/tickets/ — fetch a single ticket with its conversations embedded
GET /v1/tickets/{id}
Authorization header. See Authentication.
Authorization: Bearer rfl_live_...
ti_.Ticket object with one extra field:
createdAt ascending. Exactly
one has role: "primary".Show The Conversation object
conv_."conversation".primary (the requester’s thread) or side (an isolated thread with another party).waiting_for_user, needs_first_response, needs_follow_up, scheduled_ai_response, assumed_resolved, resolved, spam, paused, investigating, archived.curl https://api.replyful.com/v1/tickets/ti_8kNwq2Tt7yGkX9wM4bDfP \
-H "Authorization: Bearer rfl_live_..."
const res = await fetch(
"https://api.replyful.com/v1/tickets/ti_8kNwq2Tt7yGkX9wM4bDfP",
{ headers: { Authorization: `Bearer ${process.env.REPLYFUL_API_KEY}` } },
);
const ticket = await res.json();
import os, requests
res = requests.get(
"https://api.replyful.com/v1/tickets/ti_8kNwq2Tt7yGkX9wM4bDfP",
headers={"Authorization": f"Bearer {os.environ['REPLYFUL_API_KEY']}"},
)
res.raise_for_status()
ticket = res.json()
{
"id": "ti_8kNwq2Tt7yGkX9wM4bDfP",
"object": "ticket",
"title": "Refund request",
"status": "open",
"requester": {
"id": "con_9dKmT3xWq6bYrN8cJfA2eH4gp",
"name": "Ada Lovelace",
"email": { "email": "[email protected]", "verified": true }
},
"tags": [
{ "id": "tag_7fQwXk3mB9tRc2Ns6", "name": "vip" }
],
"topics": [
{ "id": "tpc_4mHbW8xKq2eYd7Tf3", "name": "Billing" }
],
"estimatedScore": null,
"createdAt": "2026-04-29T14:30:00Z",
"updatedAt": "2026-04-29T15:10:00Z",
"conversations": [
{
"id": "conv_x7Kw2mQb9tRfN4c",
"object": "conversation",
"ticketId": "ti_8kNwq2Tt7yGkX9wM4bDfP",
"role": "primary",
"status": "waiting_for_user",
"createdAt": "2026-04-29T14:30:00Z",
"updatedAt": "2026-04-29T14:32:00Z"
},
{
"id": "conv_p3Tf8xWq2mKb6rN",
"object": "conversation",
"ticketId": "ti_8kNwq2Tt7yGkX9wM4bDfP",
"role": "side",
"status": "needs_follow_up",
"createdAt": "2026-04-29T15:00:00Z",
"updatedAt": "2026-04-29T15:10:00Z"
}
]
}
| Status | error.code | When |
|---|---|---|
401 | missing_api_key | The Authorization header is absent. |
401 | invalid_api_key | The token is malformed, unknown, or archived. |
404 | ticket_not_found | The ticket does not exist or belongs to another organization. |
422 | invalid_path_parameter | The id path parameter is not a valid ti_… ID. |
429 | too_many_requests | Rate limit exceeded. Honor Retry-After. |