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 of ticket objects, each containing:
Show properties
Show properties
Unique identifier for the ticket
ID of the conversation that created this ticket
Show properties
Show properties
Customer’s name
Contact phone number
Service address
Description of the issue
Customer’s role (optional)
Ticket priority (optional)
Request type (optional)
When the ticket was created
When the ticket was submitted
Current status of the ticket
Timestamp when the ticket was created
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"
}
]
}
⌘I