{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}
{
"error": {
"type": "not_found_error",
"code": "resource_missing",
"message": "No such event.",
"request_id": "req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c",
"param": "event_id"
}
}
Tickets
Scan Ticket
Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner’s profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.
Other tickets in the same order, if the event has order scanning enabled
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tickable API","colors":{"primary":"#c89f00","light":"#ffd012","dark":"#111111"},"favicon":"https://mintcdn.com/tickable/eRwM4WLvnxdBLKhp/favicon.svg?fit=max\u0026auto=format\u0026n=eRwM4WLvnxdBLKhp\u0026q=85\u0026s=f2e8845c3bd1c79b0f9e398c848f1839","navbar":{"links":[{"href":"https://app.tickable.nl","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://app.tickable.nl/settings/developers"}},"fonts":{"heading":{"family":"Manrope","weight":800},"body":{"family":"Inter"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tickable","hasAudioNarration":false,"actualSubdomain":"tickable","customDomains":["docs.tickable.io"],"gitSource":{"type":"github","owner":"h-pops","repo":"tickable-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae21b8ed15925e7569df730","collectionId":"15c716bf-3d71-4348-8b43-91a7552ef7fd","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae21b8ed15925e7569df730"},"entitlements":{},"buildId":"6ae21b8ed15925e7569df730","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":16},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Events","count":5},{"language":"default","tag":"Orders","count":3},{"language":"default","tag":"Webhooks","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"OAuth","count":2},{"language":"default","tag":"Tickets","count":2},{"language":"default","tag":"User","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/tickets/scan-ticket","slug":"/api-reference/tickets/scan-ticket","pageMetadata":{"title":"Scan Ticket","openapi":"post /tickets/{ticket_id}/scan","description":"Scan a ticket using a scanner registered to your organization. If `scanner_id` is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the `tickets.write` scope.","href":"/api-reference/tickets/scan-ticket"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Scan a ticket using a scanner registered to your organization. If \", _jsx(_components.code, {\n children: \"scanner_id\"\n }), \" is omitted, the first active scanner in your organization is used. The scanner’s profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the \", _jsx(_components.code, {\n children: \"tickets.write\"\n }), \" scope.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Scan Ticket","openapi":"post /tickets/{ticket_id}/scan","description":"Scan a ticket using a scanner registered to your organization. If `scanner_id` is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the `tickets.write` scope.","href":"/api-reference/tickets/scan-ticket"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tickets"],"summary":"Scan ticket","description":"Scan a ticket using a scanner registered to your organization. If `scanner_id` is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the `tickets.write` scope.","operationId":"scanTicket","security":["9d9cbc51-757b-44db-8db0-8c16daead8f1"],"parameters":["b98c0720-5735-4b8f-84f0-ace03491bade"],"requestBody":"1dcd5bc2-30e9-4d8c-b899-edb0294e4902","responses":{"200":"ef7c4945-3c27-496b-a1e5-c3330dfbb75d","403":"9ece12fc-9ea8-424b-9b53-e40b8837c0bc","404":"b2ab238b-cf41-478e-8956-01968c49988f"},"method":"post","type":"path","servers":["e9234e89-f621-4a3e-931f-8b5a8425aec5"],"path":"/tickets/{ticket_id}/scan","baseUrlOptions":["https://api.tickable.io"],"title":"Scan ticket","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b98c0720-5735-4b8f-84f0-ace03491bade":{"schema":{"type":"string","format":"uuid","description":"Ticket ID","example":"c3d4e5f6-7890-4a1b-2c3d-4e5f6a7b8c9d","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true,"description":"Ticket ID","name":"ticket_id","in":"path"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"scanner_id":{"oneOf":[{"type":"string","format":"uuid","description":"Scanner ID. If omitted, the first active scanner in your organization is used.","example":"e5f6a7b8-9012-4c3d-4e5f-6a7b8c9d0e1f","uniqueKey":"scanner_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Scanner ID. If omitted, the first active scanner in your organization is used.","example":"e5f6a7b8-9012-4c3d-4e5f-6a7b8c9d0e1f","uniqueKey":"scanner_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"scanner_id","typeLabel":"string\u003cuuid> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"scanner_id":"e5f6a7b8-9012-4c3d-4e5f-6a7b8c9d0e1f"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ef7c4945-3c27-496b-a1e5-c3330dfbb75d":{"description":"Scan result","content":{"application/json":{"schema":{"type":"object","properties":{"ticket_id":{"type":"string","format":"uuid","example":"c3d4e5f6-7890-4a1b-2c3d-4e5f6a7b8c9d","isRequired":true,"uniqueKey":"ticket_id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["valid","scanned","cancelled","not_allowed"],"example":"valid","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"scanned_before":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"scanned_before","typeLabel":"boolean"},"event":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"event.id","typeLabel":"string\u003cuuid>"},"title":{"type":"string","example":"Summer Festival 2026","isRequired":true,"uniqueKey":"event.title","typeLabel":"string"},"location":{"oneOf":[{"type":"string","example":"Vondelpark","isRequired":true,"uniqueKey":"event.location.oneOf.0","typeLabel":"string"},{"type":"null","example":"Vondelpark","isRequired":true,"uniqueKey":"event.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event.location","typeLabel":"string | null"}},"required":["id","title","location"],"isRequired":true,"uniqueKey":"event","typeLabel":"object"},"timeslot":{"type":"object","properties":{"title":{"oneOf":[{"type":"string","example":"Morning Session","isRequired":true,"uniqueKey":"timeslot.title.oneOf.0","typeLabel":"string"},{"type":"null","example":"Morning Session","isRequired":true,"uniqueKey":"timeslot.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timeslot.title","typeLabel":"string | null"},"starts_at":{"oneOf":[{"type":"string","example":"2026-06-15T10:00:00Z","isRequired":true,"uniqueKey":"timeslot.starts_at.oneOf.0","typeLabel":"string"},{"type":"null","example":"2026-06-15T10:00:00Z","isRequired":true,"uniqueKey":"timeslot.starts_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timeslot.starts_at","typeLabel":"string | null"},"ends_at":{"oneOf":[{"type":"string","example":"2026-06-15T12:00:00Z","isRequired":true,"uniqueKey":"timeslot.ends_at.oneOf.0","typeLabel":"string"},{"type":"null","example":"2026-06-15T12:00:00Z","isRequired":true,"uniqueKey":"timeslot.ends_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"timeslot.ends_at","typeLabel":"string | null"}},"required":["title","starts_at","ends_at"],"isRequired":true,"uniqueKey":"timeslot","typeLabel":"object"},"ticket_type":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d","isRequired":true,"uniqueKey":"ticket_type.id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","example":"Early Bird","isRequired":true,"uniqueKey":"ticket_type.name","typeLabel":"string"},"price":{"type":"integer","description":"Price in cents (EUR), including VAT","example":2500,"isRequired":true,"uniqueKey":"ticket_type.price","typeLabel":"integer"}},"required":["id","name","price"],"isRequired":true,"uniqueKey":"ticket_type","typeLabel":"object"},"owner_name":{"type":"string","example":"Jane Doe","isRequired":true,"uniqueKey":"owner_name","typeLabel":"string"},"owner_email":{"type":"string","example":"jane@example.com","isRequired":true,"uniqueKey":"owner_email","typeLabel":"string"},"seat":{"oneOf":[{"type":"string","example":"A12","isRequired":true,"uniqueKey":"seat.oneOf.0","typeLabel":"string"},{"type":"null","example":"A12","isRequired":true,"uniqueKey":"seat.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"seat","typeLabel":"string | null"},"scanned_at":{"oneOf":[{"type":"string","example":"2026-06-15T14:30:00Z","isRequired":true,"uniqueKey":"scanned_at.oneOf.0","typeLabel":"string"},{"type":"null","example":"2026-06-15T14:30:00Z","isRequired":true,"uniqueKey":"scanned_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scanned_at","typeLabel":"string | null"},"cancelled_at":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"cancelled_at.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"cancelled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"cancelled_at","typeLabel":"string | null"},"related_tickets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"a1b2c3d4-5678-4e9f-0a1b-2c3d4e5f6a7b","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"seat":{"oneOf":[{"type":"string","example":"A13","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].seat.oneOf.0","typeLabel":"string"},{"type":"null","example":"A13","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].seat.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].seat","typeLabel":"string | null"},"owner_name":{"type":"string","example":"John Doe","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].owner_name","typeLabel":"string"},"owner_email":{"type":"string","example":"john@example.com","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].owner_email","typeLabel":"string"},"scanned_at":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].scanned_at.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].scanned_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].scanned_at","typeLabel":"string | null"},"cancelled_at":{"oneOf":[{"type":"string","example":null,"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].cancelled_at.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].cancelled_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].cancelled_at","typeLabel":"string | null"},"ticket_type_name":{"type":"string","example":"Early Bird","isRequired":true,"uniqueKey":"related_tickets.oneOf.0.items.[INDEX].ticket_type_name","typeLabel":"string"}},"required":["id","seat","owner_name","owner_email","scanned_at","cancelled_at","ticket_type_name"],"uniqueKey":"related_tickets.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Other tickets in the same order, if the event has order scanning enabled","isRequired":true,"uniqueKey":"related_tickets.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"a1b2c3d4-5678-4e9f-0a1b-2c3d4e5f6a7b"},"seat":{"oneOf":[{"type":"string","example":"A13"},{"type":"null","example":"A13"}]},"owner_name":{"type":"string","example":"John Doe"},"owner_email":{"type":"string","example":"john@example.com"},"scanned_at":{"oneOf":[{"type":"string","example":null},{"type":"null","example":null}]},"cancelled_at":{"oneOf":[{"type":"string","example":null},{"type":"null","example":null}]},"ticket_type_name":{"type":"string","example":"Early Bird"}},"required":["id","seat","owner_name","owner_email","scanned_at","cancelled_at","ticket_type_name"]},"description":"Other tickets in the same order, if the event has order scanning enabled","isRequired":true,"uniqueKey":"related_tickets.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"related_tickets","typeLabel":"object[] | null"}},"required":["ticket_id","status","scanned_before","event","timeslot","ticket_type","owner_name","owner_email","seat","scanned_at","cancelled_at","related_tickets"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ticket_id":"c3d4e5f6-7890-4a1b-2c3d-4e5f6a7b8c9d","status":"valid","scanned_before":false,"event":{"id":"550e8400-e29b-41d4-a716-446655440000","title":"Summer Festival 2026","location":"Vondelpark"},"timeslot":{"title":"Morning Session","starts_at":"2026-06-15T10:00:00Z","ends_at":"2026-06-15T12:00:00Z"},"ticket_type":{"id":"b2c4e6a8-1234-4f5a-9c8d-0e1f2a3b4c5d","name":"Early Bird","price":2500},"owner_name":"Jane Doe","owner_email":"jane@example.com","seat":"A12","scanned_at":"2026-06-15T14:30:00Z","cancelled_at":null,"related_tickets":[{"id":"a1b2c3d4-5678-4e9f-0a1b-2c3d4e5f6a7b","seat":"A13","owner_name":"John Doe","owner_email":"john@example.com","scanned_at":null,"cancelled_at":null,"ticket_type_name":"Early Bird"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"9ece12fc-9ea8-424b-9b53-e40b8837c0bc":{"description":"Scanner does not belong to your organization","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","idempotency_error","api_error"],"example":"not_found_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","example":"resource_missing","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"No such event.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support","example":"req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The parameter the error relates to, if any","example":"event_id","uniqueKey":"error.param","typeLabel":"string"}},"required":["type","code","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"not_found_error","code":"resource_missing","message":"No such event.","request_id":"req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c","param":"event_id"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b2ab238b-cf41-478e-8956-01968c49988f":{"description":"Ticket not found, or no active scanner","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","enum":["invalid_request_error","authentication_error","permission_error","not_found_error","idempotency_error","api_error"],"example":"not_found_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"enum\u003cstring>"},"code":{"type":"string","example":"resource_missing","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"No such event.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Quote this when contacting support","example":"req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"param":{"type":"string","description":"The parameter the error relates to, if any","example":"event_id","uniqueKey":"error.param","typeLabel":"string"}},"required":["type","code","message","request_id"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"not_found_error","code":"resource_missing","message":"No such event.","request_id":"req_3f2a9c1b7d4e4f0a8b6c5d2e1f0a9b8c","param":"event_id"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"9d9cbc51-757b-44db-8db0-8c16daead8f1":{"Bearer":{"type":"http","scheme":"bearer","description":"Pass as `Authorization: Bearer {token}`. Accepts either an OAuth2 JWT access token or an API key (`tk_live_...`) created from the Tickable dashboard.","scopes":[],"schemeName":"Bearer"}}},"servers":{"e9234e89-f621-4a3e-931f-8b5a8425aec5":{"url":"https://api.tickable.io","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Pass as `Authorization: Bearer {token}`. Accepts either an OAuth2 JWT access token or an API key (`tk_live_...`) created from the Tickable dashboard.","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Pass as `Authorization: Bearer {token}`. Accepts either an OAuth2 JWT access token or an API key (`tk_live_...`) created from the Tickable dashboard.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"https://api.tickable.io/doc"},"subdomain":"tickable","siteName":"Tickable API","title":"Scan Ticket - Tickable API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T15:58:37.607Z","originalFileLocation":"api-reference/tickets/scan-ticket.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner\u0026#x27;s profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tickable API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Scan Ticket - Tickable API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner\u0026#x27;s profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tickable API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tickable.io/api-reference/tickets/scan-ticket\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tickable.mintlify.app/_mintlify/api/og/v2?division=Tickets\u0026amp;title=Scan+Ticket\u0026amp;description=Scan+a+ticket+using+a+scanner+registered+to+your+organization.+If+%60scanner_id%60+is+omitted%2C+the+first+active+scanner+in+your+organization+is+used.+The+scanner%27s+\u0026amp;theme=ab314aa5095d1d3b09ff171b\u0026amp;signature=9aa2b73d82880a3360fdec46cefc1fad26c33a823dd5026bde6e7bf510bb6df7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Scan Ticket - Tickable API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner\u0026#x27;s profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tickable.mintlify.app/_mintlify/api/og/v2?division=Tickets\u0026amp;title=Scan+Ticket\u0026amp;description=Scan+a+ticket+using+a+scanner+registered+to+your+organization.+If+%60scanner_id%60+is+omitted%2C+the+first+active+scanner+in+your+organization+is+used.+The+scanner%27s+\u0026amp;theme=ab314aa5095d1d3b09ff171b\u0026amp;signature=9aa2b73d82880a3360fdec46cefc1fad26c33a823dd5026bde6e7bf510bb6df7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tickable/mYCKis5Rvuacoa5_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tickable API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c89f00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tickable.io/api-reference/tickets/scan-ticket\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tickets/scan-ticket.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tickable.io/#organization\",\"name\":\"Tickable API\",\"url\":\"https://docs.tickable.io\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tickable.io#website\",\"name\":\"Tickable API\",\"url\":\"https://docs.tickable.io\",\"publisher\":{\"@id\":\"https://docs.tickable.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket#webpage\",\"url\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket\",\"name\":\"Scan Ticket\",\"description\":\"Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.\",\"dateModified\":\"2026-10-28T15:58:37.607Z\",\"isPartOf\":{\"@id\":\"https://docs.tickable.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tickets\",\"item\":\"https://docs.tickable.io/api-reference/tickets/list-tickets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Scan Ticket\",\"item\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket#apireference\",\"headline\":\"Scan Ticket\",\"name\":\"Scan Ticket\",\"description\":\"Scan a ticket using a scanner registered to your organization. If scanner_id is omitted, the first active scanner in your organization is used. The scanner's profile rules, timeslot restrictions, and scan windows are enforced automatically. Requires the tickets.write scope.\",\"url\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tickable.io/api-reference/tickets/scan-ticket#webpage\"},\"dateModified\":\"2026-10-28T15:58:37.607Z\",\"publisher\":{\"@id\":\"https://docs.tickable.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tickable.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tickable API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tickable API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"OAuth","pages":[{"title":"Authorize","openapi":"get /oauth2/authorize","href":"/api-reference/oauth/authorize"},{"title":"Token","openapi":"post /oauth2/token","href":"/api-reference/oauth/token"}]},{"group":"Events","pages":[{"title":"List Events","openapi":"get /events","href":"/api-reference/events/list-events"},{"title":"Get Event","openapi":"get /events/{id}","href":"/api-reference/events/get-event"},{"title":"List Timeslots","openapi":"get /events/{id}/timeslots","href":"/api-reference/events/list-timeslots"},{"title":"Get Availability","openapi":"get /events/{id}/availability","href":"/api-reference/events/get-availability"},{"title":"List Ticket Types","openapi":"get /events/{id}/ticket-types","href":"/api-reference/events/list-ticket-types"}]},{"group":"Tickets","pages":[{"title":"List Tickets","openapi":"get /events/{event_id}/tickets","description":"List all tickets for an event. Optionally filter by `order_id`. Requires the `tickets.read` scope.","href":"/api-reference/tickets/list-tickets"},{"title":"Scan Ticket","openapi":"post /tickets/{ticket_id}/scan","href":"/api-reference/tickets/scan-ticket"}]},{"group":"Orders","pages":[{"title":"List orders","description":"List all orders for your organization. Optionally filter by `event_id`. Requires the `orders.read` scope.","deprecated":null,"version":null,"openapi":"https://api.tickable.io/doc get /orders","href":"/api-reference/orders/list-orders"},{"title":"Create Order","openapi":"post /orders","href":"/api-reference/orders/create-order"},{"title":"Get order","deprecated":null,"version":null,"openapi":"https://api.tickable.io/doc get /orders/{id}","href":"/api-reference/orders/get-order"}]},{"group":"Webhooks","pages":[{"title":"List Webhooks","openapi":"get /webhooks","href":"/api-reference/webhooks/list-webhooks"},{"title":"Create Webhook","openapi":"post /webhooks","href":"/api-reference/webhooks/create-webhook"},{"title":"Delete Webhook","openapi":"delete /webhooks/{id}","href":"/api-reference/webhooks/delete-webhook"}]},{"group":"User","pages":[{"title":"Get current user","deprecated":null,"version":null,"openapi":"https://api.tickable.io/doc get /whoami","href":"/api-reference/user/get-current-user"}]}]}]},"title":"Scan Ticket - Tickable API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}