Skip to main content

Validate Ticket

Validate a ticket code without redeeming it. Returns ticket details and booking information. Use this to check if a ticket is valid before check-in.

Endpoint​

POST /v1/tickets/validate

Required Scope​

tickets:read

Request Body​

ParameterTypeRequiredDescription
ticket_codestringYesThe ticket code (e.g., EQTK-A3F8X9B2) or full QR URL

Example Request​

curl -X POST https://app.equipdash.com/api/v1/tickets/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ticket_code": "EQTK-A3F8X9B2"}'

Response​

Valid Ticket​

{
  "data": {
    "valid": true,
    "message": "Ticket is valid and ready for check-in.",
    "ticket": {
      "ticket_code": "EQTK-A3F8X9B2",
      "ticket_type": "participant",
      "status": "active"
    },
    "booking": {
      "booking_id": 132,
      "booking_reference": 132,
      "customer_name": "Sophie Marshall",
      "experience_name": "Beginner Surf Lesson",
      "schedule_date": "March 28th 2026",
      "schedule_time": "7:00 AM",
      "schedule_id": 213,
      "ticket_type": "participant",
      "participant_name": "Sophie Marshall",
      "rate_category": "Adult"
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-03-28T12:00:00Z"
  }
}

Already Redeemed​

{
  "data": {
    "valid": false,
    "message": "This ticket was already checked in at 9:15 AM.",
    "ticket": {
      "ticket_code": "EQTK-A3F8X9B2",
      "ticket_type": "participant",
      "status": "redeemed"
    },
    "booking": { ... }
  }
}

Invalid / Not Found​

{
  "data": {
    "valid": false,
    "message": "Ticket not found.",
    "ticket": null,
    "booking": null
  }
}