curl 'https://api.clever.nivara.io/tickets'
{
"tickets": [
{
"ticket_id": "ticket_123",
"conversation_id": "conv_123abc456def",
"customer_info": {
"name": "John Smith",
"phone": "+1234567890",
"address": "123 Main St, City",
"issue": "Heating system not working",
"role": "tenant",
"priority": "high",
"type": "maintenance",
"date_time": "2024-03-21T10:30:00Z",
"submission_date_time": "2024-03-21T10:35:00Z"
},
"status": "open",
"created_at": "2024-03-21T10:35:00Z",
"updated_at": "2024-03-21T10:35:00Z"
},
{
"ticket_id": "ticket_456",
"conversation_id": "conv_789xyz012uvw",
"customer_info": {
"name": "Jane Doe",
"phone": "+0987654321",
"address": "456 Oak Ave, Town",
"issue": "Water leak in bathroom",
"role": "owner",
"priority": "urgent",
"type": "plumbing",
"date_time": "2024-03-21T11:00:00Z",
"submission_date_time": "2024-03-21T11:05:00Z"
},
"status": "in_progress",
"created_at": "2024-03-21T11:05:00Z",
"updated_at": "2024-03-21T11:10:00Z"
}
]
}
API Reference
Get All Tickets
Get all customer tickets from the database
GET
/
tickets
curl 'https://api.clever.nivara.io/tickets'
{
"tickets": [
{
"ticket_id": "ticket_123",
"conversation_id": "conv_123abc456def",
"customer_info": {
"name": "John Smith",
"phone": "+1234567890",
"address": "123 Main St, City",
"issue": "Heating system not working",
"role": "tenant",
"priority": "high",
"type": "maintenance",
"date_time": "2024-03-21T10:30:00Z",
"submission_date_time": "2024-03-21T10:35:00Z"
},
"status": "open",
"created_at": "2024-03-21T10:35:00Z",
"updated_at": "2024-03-21T10:35:00Z"
},
{
"ticket_id": "ticket_456",
"conversation_id": "conv_789xyz012uvw",
"customer_info": {
"name": "Jane Doe",
"phone": "+0987654321",
"address": "456 Oak Ave, Town",
"issue": "Water leak in bathroom",
"role": "owner",
"priority": "urgent",
"type": "plumbing",
"date_time": "2024-03-21T11:00:00Z",
"submission_date_time": "2024-03-21T11:05:00Z"
},
"status": "in_progress",
"created_at": "2024-03-21T11:05:00Z",
"updated_at": "2024-03-21T11:10:00Z"
}
]
}
Retrieve a list of all customer tickets stored in the database.
Response
Returns an array of ticket objects. Each ticket contains the customer information and conversation details that led to its creation.array
Array of ticket objects, each containing:
Show properties
Show properties
string
Unique identifier for the ticket
string
ID of the conversation that created this ticket
object
string
Current status of the ticket
string
Timestamp when the ticket was created
string
Timestamp of last ticket update
curl 'https://api.clever.nivara.io/tickets'
{
"tickets": [
{
"ticket_id": "ticket_123",
"conversation_id": "conv_123abc456def",
"customer_info": {
"name": "John Smith",
"phone": "+1234567890",
"address": "123 Main St, City",
"issue": "Heating system not working",
"role": "tenant",
"priority": "high",
"type": "maintenance",
"date_time": "2024-03-21T10:30:00Z",
"submission_date_time": "2024-03-21T10:35:00Z"
},
"status": "open",
"created_at": "2024-03-21T10:35:00Z",
"updated_at": "2024-03-21T10:35:00Z"
},
{
"ticket_id": "ticket_456",
"conversation_id": "conv_789xyz012uvw",
"customer_info": {
"name": "Jane Doe",
"phone": "+0987654321",
"address": "456 Oak Ave, Town",
"issue": "Water leak in bathroom",
"role": "owner",
"priority": "urgent",
"type": "plumbing",
"date_time": "2024-03-21T11:00:00Z",
"submission_date_time": "2024-03-21T11:05:00Z"
},
"status": "in_progress",
"created_at": "2024-03-21T11:05:00Z",
"updated_at": "2024-03-21T11:10:00Z"
}
]
}