Tickets
Ticket scanning and validation for event staff
List scannable ticket events
Authorization
ApiKeyAuth x-api-key<token>
API key is automatically provided for demo requests in the playground
In: header
Response Body
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/tickets/events"{
"events": [
{
"id": "clx123event",
"name": "Summer Festival 2026",
"location": "Suvilahti, Helsinki",
"startDate": "2026-06-15T12:00:00.000Z",
"endDate": "2026-06-17T23:00:00.000Z"
}
]
}{
"error": "Error message"
}Validate scanner PIN for an event
Authorization
ApiKeyAuth x-api-key<token>
API key is automatically provided for demo requests in the playground
In: header
Request Body
application/json
eventId*string
ID of the event to authenticate for
pin*string
Scanner PIN code (set by store owner in dashboard)
Response Body
application/json
application/json
application/json
curl -X POST "https://test.putiikkipalvelu.fi/api/storefront/v1/tickets/validate-pin" \ -H "Content-Type: application/json" \ -d '{ "eventId": "clx123event", "pin": "1234" }'{
"success": true,
"event": {
"id": "clx123event",
"name": "Summer Festival 2026",
"location": "Suvilahti, Helsinki",
"startDate": "2026-06-15T12:00:00.000Z",
"endDate": "2026-06-17T23:00:00.000Z"
}
}{
"error": "Virheellinen PIN-koodi"
}{
"error": "Error message"
}Use (scan) a ticket
Authorization
ApiKeyAuth x-api-key<token>
API key is automatically provided for demo requests in the playground
In: header
Request Body
application/json
code*string
Ticket code from QR scan
eventId*string
Event ID being scanned at
Response Body
application/json
application/json
application/json
curl -X POST "https://test.putiikkipalvelu.fi/api/storefront/v1/tickets/use" \ -H "Content-Type: application/json" \ -d '{ "code": "550e8400-e29b-41d4-a716-446655440000", "eventId": "clx123event" }'{
"success": true,
"message": "Lippu käytetty onnistuneesti",
"ticket": {
"id": "clx789ticket",
"code": "550e8400-e29b-41d4-a716-446655440000",
"status": "USED",
"usedCount": 1,
"maxUses": 1,
"productName": "Festival Day Pass",
"eventName": "Summer Festival 2026"
}
}{
"error": "Error message"
}{
"error": "Lippua ei löydy"
}Get ticket details by code
Authorization
ApiKeyAuth x-api-key<token>
API key is automatically provided for demo requests in the playground
In: header
Path Parameters
code*string
The unique ticket code (UUID)
Response Body
application/json
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/tickets/550e8400-e29b-41d4-a716-446655440000"{
"success": true,
"ticket": {
"id": "clx789ticket",
"code": "550e8400-e29b-41d4-a716-446655440000",
"status": "VALID",
"ticketEventId": "string",
"firstName": "string",
"lastName": "string",
"customerEmail": "user@example.com",
"productName": "string",
"eventName": "string",
"eventDate": "2019-08-24T14:15:22Z",
"price": 2500,
"usedCount": 0,
"maxUses": 1,
"validFrom": "2019-08-24T14:15:22Z",
"validUntil": "2019-08-24T14:15:22Z",
"lastUsedAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z"
}
}{
"error": "Error message"
}{
"error": "Lippua ei löydy"
}