Create Support Ticket

Open a new support ticket to contact the agency's customer service team. Support tickets provide a structured way to report issues, ask questions, or request assistance with your bookings.

When creating a ticket, you can optionally link it to a specific booking. This is especially useful for vehicle-related issues, as it gives the support team immediate context about which vehicle you're using and your booking details.

Priority levels help the support team triage incoming requests:

• Critical/High: For urgent issues during active rentals (vehicle breakdowns, safety concerns)
• Normal: Standard inquiries and non-urgent issues
• Low: General feedback or questions that don't need immediate attention

For Urgent Issues

If you're experiencing an emergency or vehicle breakdown during an active rental, set the priority to "critical" and include your location. The agency will prioritize your request accordingly.

Endpoint

INFO

POST /api/v1/client/tickets

Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Request Body

Parameter	Type	Required	Description
subject	string	Yes	Ticket subject (max: 255)
message	string	Yes	Initial message
category	string	Yes	Ticket category
priority	string	No	Priority level (default: normal)
booking_id	integer	No	Related booking ID
attachments	array	No	Array of attachment URLs

Example Request

curl -X POST https://api.daakey.com/api/v1/client/tickets \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}" \
  -d '{
    "subject": "Vehicle not starting",
    "message": "I am unable to start the vehicle. The dashboard shows an error message.",
    "category": "vehicle_issue",
    "priority": "high",
    "booking_id": 5
  }'

Response

Success (201)

{
  "success": true,
  "message": "Ticket created successfully",
  "data": {
    "id": 3,
    "reference": "TK-2024-00003",
    "subject": "Vehicle not starting",
    "status": "open",
    "priority": "high",
    "category": "vehicle_issue",
    "booking": {
      "id": 5,
      "reference": "BK-2024-00005",
      "vehicle": {
        "plate_number": "ABC-123",
        "brand": "Toyota",
        "model": "Corolla"
      }
    },
    "messages": [
      {
        "id": 1,
        "message": "I am unable to start the vehicle. The dashboard shows an error message.",
        "sender": "client",
        "created_at": "2024-01-15T10:00:00Z"
      }
    ],
    "created_at": "2024-01-15T10:00:00Z"
  },
  "meta": {
    "agency_id": 123,
    "agency_code": "AGENCY123"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (422)

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "category": ["The selected category is invalid."]
  },
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Categories

Category	Description
vehicle_issue	Problems with the vehicle
booking	Booking-related questions
billing	Payment and billing issues
account	Account-related issues
general	General inquiries

Priority Levels

Priority	Description
low	Non-urgent issues
normal	Standard priority
high	Urgent issues
critical	Emergency (vehicle breakdown)