{"openapi":"3.1.0","info":{"title":"Naija Tickets Integration API","version":"1.8.0","description":"Implemented contract through Phase 8. Server secret keys stay on partner servers; public widgets use separate identifiers. Externally managed events are private backing records that reuse Naija Tickets checkout and tickets. Single-project Test operations use hidden test event copies and Paystack Test credentials in the existing app/database. Live purchases use Live credentials and separate inventory. Features fail closed until configured. Public sandbox purchase, receiver and scheduled-delivery acceptance must be recorded separately; this document is not proof of activation."},"servers":[{"url":"/","description":"This deployment origin. Use this same origin with a Test key for test purchases. Test event copies isolate inventory; no second account or project is required when single-project testing is enabled."}],"paths":{"/api/v1/integration":{"get":{"operationId":"phase3_get__api_v1_integration","summary":"Inspect the authenticated integration","security":[{"Phase3IntegrationSecret":[]}],"responses":{"200":{"description":"Integration identity and currently supported capabilities; no secret material.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","name","organiser_id","environment","scopes","key_id","expires_at","capabilities"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"organiser_id":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["test","live"]},"scopes":{"type":"array","items":{"type":"string","enum":["integration:read","events:read","tickets:read","availability:read","checkout:write","external_events:write","orders:read","tickets:status","attendees:read","attendees:contact","sales:read","groups:read","refunds:read","entry:verify","entry:check-in"]}},"key_id":{"type":"string","format":"uuid"},"expires_at":{"type":"string","format":"date-time"},"capabilities":{"type":"object","required":["introspection","event_api","hosted_checkout","widget","sandbox_purchases","advanced_operations","delegated_entry"],"properties":{"introspection":{"type":"boolean","const":true},"event_api":{"type":"boolean","description":"Reports current deployment configuration for this credential mode. Individual operations still require their own scopes; this is not payment proof."},"hosted_checkout":{"type":"boolean","description":"Reports current deployment configuration for this credential mode. Individual operations still require their own scopes; this is not payment proof."},"widget":{"type":"boolean","const":false},"sandbox_purchases":{"type":"boolean","description":"Reports current deployment configuration for this credential mode. Individual operations still require their own scopes; this is not payment proof."},"advanced_operations":{"type":"boolean","description":"Deployment configuration only; individual operations still require explicit scopes and current grants."},"delegated_entry":{"type":"boolean","description":"Deployment configuration only; individual operations still require explicit scopes and current grants."}}}}},"meta":{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"401":{"description":"Invalid, missing, expired, revoked or disabled key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3Error"}}}},"403":{"description":"Missing integration:read scope or browser Origin provided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3Error"}}}},"429":{"description":"Shared rate budget exhausted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds until the current rate window resets."}}},"503":{"description":"Resource mode unavailable or dependency/configuration outage; isolated test database required for Test resource access.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3Error"}}}}},"tags":["Identity"]}},"/api/v1/events":{"get":{"operationId":"phase3_get__api_v1_events","summary":"List assigned, published events that have not ended","description":"Requires events:read. Event grants, ownership, active credential, issuer management permission and live mode are rechecked in the database. No CORS/browser secret-key use. Unknown/repeated query parameters are rejected.","security":[{"Phase3IntegrationSecret":[]}],"x-required-scope":"events:read","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Number of records returned."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque next_cursor from this same application, mode, resource and filters. Keep filters unchanged; limit may change."},{"name":"city","in":"query","schema":{"type":"string","minLength":1,"maxLength":80},"description":"Exact city name, case insensitive."},{"name":"category","in":"query","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,63}$"},"description":"Exact category slug, such as concert."},{"name":"starts_from","in":"query","schema":{"type":"string","format":"date-time"},"description":"Inclusive event start lower bound. ISO timezone required; at most three fractional second digits."},{"name":"starts_before","in":"query","schema":{"type":"string","format":"date-time"},"description":"Exclusive event start upper bound. ISO timezone required; at most three fractional second digits."}],"responses":{"200":{"description":"Read-only response. Private, no-store; event changes can affect later pages.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase3Event"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query or page cursor.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, revoked, expired, disabled or wrong-mode key.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Missing scope or browser Origin not permitted.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"GET only; Allow: GET.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded; Retry-After seconds.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"Resource mode unavailable or dependency/configuration outage; isolated test database required for Test resource access.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Events"]}},"/api/v1/events/{eventId}":{"get":{"operationId":"phase3_get__api_v1_events_eventId_","summary":"Read public event information","description":"Requires events:read. Event grants, ownership, active credential, issuer management permission and live mode are rechecked in the database. No CORS/browser secret-key use. Unknown/repeated query parameters are rejected.","security":[{"Phase3IntegrationSecret":[]}],"x-required-scope":"events:read","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read-only response. Private, no-store; event changes can affect later pages.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase3Event"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query or page cursor.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, revoked, expired, disabled or wrong-mode key.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Missing scope or browser Origin not permitted.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"404":{"description":"Unknown, foreign, unassigned, unpublished, cancelled or ended event.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"GET only; Allow: GET.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded; Retry-After seconds.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"Resource mode unavailable or dependency/configuration outage; isolated test database required for Test resource access.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Events"]}},"/api/v1/events/{eventId}/tickets":{"get":{"operationId":"phase3_get__api_v1_events_eventId_tickets","summary":"Read active ticket types, current package prices and sale restrictions","description":"Requires tickets:read. Event grants, ownership, active credential, issuer management permission and live mode are rechecked in the database. No CORS/browser secret-key use. Unknown/repeated query parameters are rejected.","security":[{"Phase3IntegrationSecret":[]}],"x-required-scope":"tickets:read","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Number of records returned."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque next_cursor from this same application, mode, resource and filters. Keep filters unchanged; limit may change."}],"responses":{"200":{"description":"Read-only response. Private, no-store; event changes can affect later pages.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase3TicketType"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query or page cursor.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, revoked, expired, disabled or wrong-mode key.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Missing scope or browser Origin not permitted.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"404":{"description":"Unknown, foreign, unassigned, unpublished, cancelled or ended event.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"GET only; Allow: GET.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded; Retry-After seconds.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"Resource mode unavailable or dependency/configuration outage; isolated test database required for Test resource access.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Tickets"]}},"/api/v1/events/{eventId}/availability":{"get":{"operationId":"phase3_get__api_v1_events_eventId_availability","summary":"Read advisory admission and package inventory","description":"Requires availability:read. Event grants, ownership, active credential, issuer management permission and live mode are rechecked in the database. No CORS/browser secret-key use. Unknown/repeated query parameters are rejected.","security":[{"Phase3IntegrationSecret":[]}],"x-required-scope":"availability:read","parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Read-only response. Private, no-store; event changes can affect later pages.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase3Availability"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query or page cursor.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, revoked, expired, disabled or wrong-mode key.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Missing scope or browser Origin not permitted.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"404":{"description":"Unknown, foreign, unassigned, unpublished, cancelled or ended event.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"GET only; Allow: GET.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded; Retry-After seconds.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"Resource mode unavailable or dependency/configuration outage; isolated test database required for Test resource access.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Present for HTTP 429."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Events"]}},"/api/v1/checkout-sessions":{"post":{"operationId":"phase3_post__api_v1_checkout_sessions","summary":"Create or replay a hosted checkout intent","description":"Requires checkout:write and Idempotency-Key. No stock is held and no order/ticket/payment is created until the customer submits the hosted form. Inputs cannot include price, customer identity or attendee details. Max 400 admissions and per-tier sale/order restrictions apply. Session lifetime up to 30 minutes, bounded by issuing credential expiry.","x-required-scope":"checkout:write","security":[{"Phase3IntegrationSecret":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9_.-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3CheckoutIntent"},"example":{"event_id":"30000000-0000-4000-8000-000000000001","items":[{"ticket_type_id":"40000000-0000-4000-8000-000000000001","quantity":2}],"return_url":"https://partner.example/complete","cancel_url":"https://partner.example/cancel"}}}},"responses":{"200":{"description":"Private, no-store response with request ID. Replays return the original session.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase3CheckoutCreated"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid body, query, selection, Idempotency-Key or registered return URL.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, expired, revoked or disabled credential.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Required scope missing or browser Origin denied. Server requests only.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"404":{"description":"Session/event not found within the authenticated application and current event grant.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"Wrong method; Allow header names the supported method.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"409":{"description":"IDEMPOTENCY_CONFLICT for changed payload; CHECKOUT_CONFLICT for unavailable selection or other booking conflicts.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"413":{"description":"Body exceeds 16 KiB.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"415":{"description":"Content-Type must be application/json.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"CHECKOUT_NOT_CONFIGURED, SANDBOX_NOT_CONFIGURED or dependency outage; never falls back to live resources.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Checkout"]}},"/api/v1/checkout-sessions/{sessionId}":{"get":{"operationId":"phase3_get__api_v1_checkout_sessions_sessionId_","summary":"Read minimal authoritative checkout status","description":"Requires orders:read. Only this application/environment’s sessions with a current authorised event grant are readable. Historical status remains available after an event ends. No query parameters, purchaser information, QR codes, usable ticket/receipt links or checkout capability. Redirect nt_status is advisory: verify this API before updating a partner order.","x-required-scope":"orders:read","security":[{"Phase3IntegrationSecret":[]}],"parameters":[{"name":"sessionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Private, no-store response with request ID. Replays return the original session.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase3CheckoutSession"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid body, query, selection, Idempotency-Key or registered return URL.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"401":{"description":"Invalid, expired, revoked or disabled credential.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"403":{"description":"Required scope missing or browser Origin denied. Server requests only.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"404":{"description":"Session/event not found within the authenticated application and current event grant.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"405":{"description":"Wrong method; Allow header names the supported method.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"429":{"description":"Shared request budget exceeded.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}},"503":{"description":"CHECKOUT_NOT_CONFIGURED, SANDBOX_NOT_CONFIGURED or dependency outage; never falls back to live resources.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase3ReadError"}}}}},"tags":["Checkout"]}},"/embed/events/{eventId}":{"get":{"summary":"Render a public iframe for an assigned published event","security":[],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"widget","in":"query","required":true,"schema":{"type":"string","pattern":"^nt_widget_[a-f0-9]{32}$"}},{"name":"environment","in":"query","required":true,"schema":{"type":"string","enum":["test","live"]}},{"name":"parent_origin","in":"query","required":true,"schema":{"type":"string"}},{"name":"return_url","in":"query","required":false,"schema":{"type":"string","format":"uri"}},{"name":"channel","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{32}$"}},{"name":"appearance","in":"query","required":false,"schema":{"type":"string","enum":["light","dark"]},"description":"Validated optional snippet appearance; no arbitrary CSS."},{"name":"accent","in":"query","required":false,"schema":{"type":"string","enum":["green","blue","violet"]},"description":"Validated optional snippet appearance; no arbitrary CSS."},{"name":"button","in":"query","required":false,"schema":{"type":"string","enum":["rounded","square"]},"description":"Validated optional snippet appearance; no arbitrary CSS."}],"responses":{"200":{"description":"Standalone no-store event/ticket HTML with exact frame-ancestors and optional signed checkout form.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"400":{"description":"Invalid fields, environment, origin or return path."},"403":{"description":"Wrong origin or current permission denied."},"404":{"description":"Widget/application/event unavailable."},"405":{"description":"Method not allowed."},"409":{"description":"Configuration, inventory or idempotency conflict."},"429":{"description":"Shared rate limit exceeded; Retry-After header."},"503":{"description":"Feature, resource binding, limiter or hosted configuration unavailable."}},"operationId":"phase5_get__embed_events_eventId_","tags":["Widgets"]}},"/api/integrations/widgets/{widgetId}/events/{eventId}":{"get":{"summary":"Read public widget configuration without secret credentials","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","pattern":"^nt_widget_[a-f0-9]{32}$"}},{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"environment","in":"query","required":true,"schema":{"type":"string","enum":["test","live"]}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact registered website origin in the selected environment. No Authorization header is accepted."}],"responses":{"200":{"description":"Exact-origin CORS; no credentials or checkout proof/private capability. Quantities/prices are advisory.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/Phase5WidgetSnapshot"}},"required":["data"]}}}},"400":{"description":"Invalid fields, environment, origin or return path.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"403":{"description":"Wrong origin or current permission denied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"404":{"description":"Widget/application/event unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"409":{"description":"Configuration, inventory or idempotency conflict.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}},"503":{"description":"Feature, resource binding, limiter or hosted configuration unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase5PublicError"}}}}},"operationId":"phase5_get__api_integrations_widgets_widgetId_events_eventId_","tags":["Widgets"]},"options":{"summary":"Validate a GET-only, header-free CORS preflight","security":[],"parameters":[{"name":"widgetId","in":"path","required":true,"schema":{"type":"string","pattern":"^nt_widget_[a-f0-9]{32}$"}},{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"environment","in":"query","required":true,"schema":{"type":"string","enum":["test","live"]}},{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Exact registered website origin in the selected environment. No Authorization header is accepted."},{"name":"Access-Control-Request-Method","in":"header","required":true,"schema":{"type":"string","const":"GET"}}],"responses":{"204":{"description":"Exact-origin Access-Control-Allow-Origin; Allow-Methods GET; max-age 60. No custom request headers or credentials permitted."},"400":{"description":"Invalid fields, environment, origin or return path."},"403":{"description":"Wrong origin or current permission denied."},"404":{"description":"Widget/application/event unavailable."},"405":{"description":"Method not allowed."},"409":{"description":"Configuration, inventory or idempotency conflict."},"429":{"description":"Shared rate limit exceeded; Retry-After header."},"503":{"description":"Feature, resource binding, limiter or hosted configuration unavailable."}},"operationId":"phase5_options__api_integrations_widgets_widgetId_events_eventId_","tags":["Widgets"]}},"/integrations/widget-checkout":{"post":{"summary":"Submit a native user-activated form and navigate to existing hosted checkout","description":"Not a cross-origin JSON API. Requires Naija frame Origin, no Authorization and, when present, Sec-Fetch-Dest=document. Five-minute signed proof; no prices, customer IDs or attendee details. Duplicate proof/intent replays the existing session. Max 16 KiB/five seconds, 20 selected tiers, 20 packages/tier and 400 admissions.","security":[],"parameters":[{"name":"Origin","in":"header","required":true,"schema":{"type":"string"},"description":"Trusted Naija deployment origin, not the embedding partner origin."}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["proof"],"properties":{"proof":{"type":"string","maxLength":8192},"promo_code":{"type":"string","maxLength":32}},"patternProperties":{"^quantity_[a-f0-9-]{36}$":{"type":"string","pattern":"^(0|[1-9][0-9]?)$"}},"additionalProperties":false,"maxProperties":102}}}},"responses":{"303":{"description":"Private/no-store redirect to existing signed hosted URL. Middleware exchanges access into a first-party HttpOnly cookie and cleans the URL. Never publish/log the Location capability.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}},"Location":{"schema":{"type":"string","format":"uri"}}}},"400":{"description":"Invalid fields, environment, origin or return path.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"403":{"description":"Wrong origin or current permission denied.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"404":{"description":"Widget/application/event unavailable.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"405":{"description":"Method not allowed.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"409":{"description":"Configuration, inventory or idempotency conflict.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"410":{"description":"Expired/invalid selection proof; refresh the widget.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"413":{"description":"Selection body too large.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"415":{"description":"Use application/x-www-form-urlencoded.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After header.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}},"503":{"description":"Feature, resource binding, limiter or hosted configuration unavailable.","headers":{"X-Request-ID":{"description":"Safe request identifier.","schema":{"type":"string"}},"Cache-Control":{"description":"private, no-store","schema":{"type":"string"}}},"content":{"text/html":{"schema":{"type":"string"}}}}},"operationId":"phase5_post__integrations_widget_checkout","tags":["Widgets"]}},"/api/v1/orders":{"get":{"summary":"Read application-attributed order data","description":"Requires orders:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["orders:read"],"parameters":[{"name":"event_id","in":"query","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque UUID-keyset cursor bound to application/mode/scopes/operation/filter. Lists order by resource UUID ascending."}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase6Order"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_orders","tags":["Orders"]}},"/api/v1/orders/{orderId}":{"get":{"summary":"Read application-attributed order data","description":"Requires orders:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["orders:read"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase6Order"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_orders_orderId_","tags":["Orders"]}},"/api/v1/orders/{orderId}/tickets":{"get":{"summary":"Read application-attributed ticket data","description":"Requires tickets:status. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["tickets:status"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque UUID-keyset cursor bound to application/mode/scopes/operation/filter. Lists order by resource UUID ascending."}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase6Ticket"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_orders_orderId_tickets","tags":["Orders"]}},"/api/v1/tickets/{ticketId}":{"get":{"summary":"Read application-attributed ticket data","description":"Requires tickets:status. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["tickets:status"],"parameters":[{"name":"ticketId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase6Ticket"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_tickets_ticketId_","tags":["Tickets"]}},"/api/v1/events/{eventId}/attendees":{"get":{"summary":"Read application-attributed attendee data","description":"Requires attendees:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["attendees:read"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque UUID-keyset cursor bound to application/mode/scopes/operation/filter. Lists order by resource UUID ascending."}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase6Attendee"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_events_eventId_attendees","tags":["Attendees"]}},"/api/v1/orders/{orderId}/groups":{"get":{"summary":"Read application-attributed group data","description":"Requires groups:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["groups:read"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque UUID-keyset cursor bound to application/mode/scopes/operation/filter. Lists order by resource UUID ascending."}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase6Group"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_orders_orderId_groups","tags":["Groups"]}},"/api/v1/orders/{orderId}/refunds":{"get":{"summary":"Read application-attributed refund data","description":"Requires refunds:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["refunds:read"],"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":1024},"description":"Opaque UUID-keyset cursor bound to application/mode/scopes/operation/filter. Lists order by resource UUID ascending."}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Phase6Refund"},"maxItems":100},"meta":{"type":"object","additionalProperties":false,"required":["request_id","next_cursor"],"properties":{"request_id":{"type":"string","format":"uuid"},"next_cursor":{"type":["string","null"]}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_orders_orderId_refunds","tags":["Refunds"]}},"/api/v1/sales-summary":{"get":{"summary":"Read application-attributed sales data","description":"Requires sales:read. Current app/mode/creator/event ownership and event grants apply; never all marketplace customers. Contact fields require attendees:contact as well as attendees:read. Historical reads may include ended/unpublished granted events. See guide for sales/refund semantics.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["sales:read"],"parameters":[{"name":"event_id","in":"query","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase6Sales"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_get__api_v1_sales_summary","tags":["Sales"]}},"/api/v1/events/{eventId}/check-ins":{"post":{"summary":"Verify or admit an attributed ticket as the current key creator","description":"Requires entry:verify; admit also requires entry:check-in. Explicit deployment flags required. Only assigned published non-ended events and this application’s claimed tickets; actor cannot be supplied. Reuses existing locked venue engine and records key/creator audit. A replay is a historical operation result, not proof of current ticket validity. Thirty entry requests/key/min and 120/organiser/min, plus existing shared limits. Retained for seven days, cap 10,000 rows/application.","security":[{"Phase6ServerAPIKey":[]}],"x-required-scopes":["entry:verify"],"parameters":[{"name":"eventId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6EntryInput"}}}},"responses":{"200":{"description":"Server-only no-store response; explicit projection excludes QR, receipt/invite/claim capabilities, buyer and provider payloads.","headers":{"X-Request-ID":{"schema":{"type":"string","format":"uuid"}},"Cache-Control":{"schema":{"type":"string"},"description":"private, no-store"},"Referrer-Policy":{"schema":{"type":"string"},"description":"no-referrer"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Phase6EntryResult"},"meta":{"type":"object","additionalProperties":false,"required":["request_id"],"properties":{"request_id":{"type":"string","format":"uuid"}}}}}}}},"400":{"description":"Invalid query, cursor, identifier or JSON fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"401":{"description":"Invalid/expired/revoked key, disabled application or creator no longer authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"403":{"description":"Required operation permission missing, browser Origin forbidden or entry principal not authorised.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"404":{"description":"No matching currently granted and reciprocally application-attributed resource; unrelated and nonexistent are indistinguishable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"405":{"description":"Unsupported method; Allow identifies the accepted method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"409":{"description":"Entry idempotency payload conflict or retained-history bound reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"410":{"description":"Retained entry replay has expired; new request still cannot bypass one-time entry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"413":{"description":"JSON body exceeds 4 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"429":{"description":"Shared rate limit exceeded; Retry-After identifies the wait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}},"503":{"description":"Operation flags off, environment binding unavailable/mismatched, storage or limits unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase6Error"}}}}},"operationId":"phase6_post__api_v1_events_eventId_check_ins","tags":["Entry"]}},"/api/v1/external-events/{externalId}":{"put":{"summary":"Create or update an externally managed event","description":"Requires external_events:write. A stable externalId makes this operation idempotent. Ticket prices are integer NGN kobo and capacity is packages multiplied by admissions_per_ticket.","security":[{"Phase8IntegrationKey":["external_events:write"]}],"parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase8ExternalEventInput"}}}},"responses":{"200":{"description":"The private backing event is ready for hosted checkout or an enabled widget.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase8ExternalEventResponse"}}}},"400":{"description":"Invalid dates, ticket values or duplicate external ticket identifiers."},"401":{"description":"Missing, expired or invalid server key."},"403":{"description":"Browser requests and keys without external_events:write are denied."},"409":{"description":"A price/admission change after orders, or capacity below sold or reserved admissions, is denied."},"503":{"description":"Test resource mode is not configured."}},"operationId":"phase8_put__api_v1_external_events_externalId_","tags":["Events"]}},"/api/v1/openapi.json":{"get":{"operationId":"downloadPublicOpenApi","tags":["Documentation"],"summary":"Download this public contract; no API key required","security":[],"responses":{"200":{"description":"OpenAPI 3.1 JSON document. Public schema only; configuration and deployment acceptance are separate."}}}}},"components":{"schemas":{"Phase3Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string","format":"uuid"}}}}},"Phase3Event":{"type":"object","additionalProperties":false,"required":["id","title","slug","description","image_url","venue","starts_at","ends_at","timezone","sales_start_at","sales_end_at","organiser","category"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"image_url":{"type":["string","null"]},"venue":{"type":"object","additionalProperties":false,"required":["name","address","city","state"],"properties":{"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"}}},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"sales_start_at":{"type":["string","null"],"format":"date-time"},"sales_end_at":{"type":["string","null"],"format":"date-time"},"organiser":{"type":"object","additionalProperties":false,"required":["id","name","verified"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"verified":{"type":"boolean"}}},"category":{"type":"object","additionalProperties":false,"required":["id","name","slug"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"}}}}},"Phase3TicketType":{"type":"object","additionalProperties":false,"required":["id","event_id","name","description","currency","price_kobo","standard_price_kobo","price_kind","early_bird_price_kobo","early_bird_ends_at","admissions_per_ticket","min_packages_per_order","max_packages_per_order","sales_start_at","sales_end_at","sale_status","fees_included","promo_discount_included"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"currency":{"const":"NGN","type":"string"},"price_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"standard_price_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"price_kind":{"type":"string","enum":["standard","early_bird"]},"early_bird_price_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"early_bird_ends_at":{"type":["string","null"],"format":"date-time"},"admissions_per_ticket":{"type":"integer","minimum":1},"min_packages_per_order":{"type":"integer","minimum":0,"maximum":9007199254740991},"max_packages_per_order":{"type":"integer","minimum":0,"maximum":9007199254740991},"sales_start_at":{"type":["string","null"],"format":"date-time"},"sales_end_at":{"type":["string","null"],"format":"date-time"},"sale_status":{"type":"string","enum":["open","upcoming","closed","sold_out","allocation_limited"]},"fees_included":{"const":false,"type":"boolean"},"promo_discount_included":{"const":false,"type":"boolean"}}},"Phase3TicketAvailability":{"type":"object","additionalProperties":false,"required":["ticket_type_id","admissions_per_ticket","total_admissions","sold_admissions","reserved_admissions","remaining_admissions","remaining_packages","early_bird_remaining_packages","max_packages_at_current_price","sale_status"],"properties":{"ticket_type_id":{"type":"string","format":"uuid"},"admissions_per_ticket":{"type":"integer","minimum":1},"total_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"sold_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining_packages":{"type":"integer","minimum":0,"maximum":9007199254740991},"early_bird_remaining_packages":{"type":["integer","null"],"minimum":0},"max_packages_at_current_price":{"type":"integer","minimum":0,"maximum":9007199254740991},"sale_status":{"type":"string","enum":["open","upcoming","closed","sold_out","allocation_limited"]}}},"Phase3Availability":{"type":"object","additionalProperties":false,"required":["event_id","as_of","advisory","total_admissions","sold_admissions","reserved_admissions","remaining_admissions","ticket_types"],"properties":{"event_id":{"type":"string","format":"uuid"},"as_of":{"type":"string","format":"date-time"},"advisory":{"const":true,"type":"boolean"},"total_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"sold_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"reserved_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticket_types":{"type":"array","items":{"$ref":"#/components/schemas/Phase3TicketAvailability"},"maxItems":100}}},"Phase3ReadError":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string","format":"uuid"}}}}},"Phase3CheckoutSession":{"type":"object","additionalProperties":false,"required":["id","event_id","environment","status","expires_at","reservation_expires_at","currency","admissions","subtotal_kobo","discount_kobo","fee_kobo","total_kobo","tickets_issued","members_registered","source","external_reference"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["test","live"]},"status":{"type":"string","enum":["open","reserved","pending","paid","failed","expired","cancelled","refunded","partially_refunded"]},"expires_at":{"type":"string","format":"date-time"},"reservation_expires_at":{"type":["string","null"],"format":"date-time"},"currency":{"type":"string","const":"NGN"},"admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"discount_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"fee_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"total_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"tickets_issued":{"type":"integer","minimum":0,"maximum":9007199254740991},"members_registered":{"type":"integer","minimum":0,"maximum":9007199254740991},"source":{"type":"string","enum":["hosted_api","hosted_link","legacy_widget"]},"external_reference":{"type":["string","null"],"maxLength":100}},"description":"Minimal status of this integration-attributed session. Monetary fields are null before reservation. Admissions include unclaimed group slots; tickets_issued counts usable claimed/checked-in tickets, not unclaimed group slots. Paid/refund status requires stored verified payment. No private receipt, purchaser, attendee or QR data."},"Phase3CheckoutCreated":{"type":"object","additionalProperties":false,"required":["id","event_id","environment","status","expires_at","reservation_expires_at","currency","admissions","subtotal_kobo","discount_kobo","fee_kobo","total_kobo","tickets_issued","members_registered","checkout_url"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"environment":{"type":"string","enum":["test","live"]},"status":{"type":"string","enum":["open","reserved","pending","paid","failed","expired","cancelled","refunded","partially_refunded"]},"expires_at":{"type":"string","format":"date-time"},"reservation_expires_at":{"type":["string","null"],"format":"date-time"},"currency":{"type":"string","const":"NGN"},"admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"subtotal_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"discount_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"fee_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"total_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"tickets_issued":{"type":"integer","minimum":0,"maximum":9007199254740991},"members_registered":{"type":"integer","minimum":0,"maximum":9007199254740991},"checkout_url":{"type":"string","format":"uri","description":"Short-lived private buyer capability. Return to the buyer only; redact from logs and analytics. It is not a server API credential."},"source":{"type":"string","enum":["hosted_api","hosted_link","legacy_widget"]},"external_reference":{"type":"string","maxLength":100}}},"Phase3CheckoutIntent":{"type":"object","additionalProperties":false,"required":["event_id","return_url"],"properties":{"event_id":{"type":"string","format":"uuid"},"items":{"type":"array","minItems":0,"maxItems":20,"items":{"type":"object","additionalProperties":false,"required":["ticket_type_id","quantity"],"properties":{"ticket_type_id":{"type":"string","format":"uuid"},"quantity":{"type":"integer","minimum":1,"maximum":20}}},"description":"Optional package selections. Omit or send [] to let the customer choose on the hosted checkout."},"promo_code":{"type":["string","null"],"maxLength":32,"description":"Optional code; normalized to uppercase and validated during authoritative reservation."},"return_url":{"type":"string","format":"uri","maxLength":2048,"description":"Exact registered origin plus simple path. No credentials, query, fragment, percent escapes or backslashes. HTTPS; test localhost HTTP allowed."},"cancel_url":{"type":"string","format":"uri","maxLength":2048,"description":"Same restrictions as return_url; defaults to return_url."},"customer":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","format":"email","maxLength":254},"name":{"type":"string","minLength":2,"maxLength":120},"phone":{"type":"string","minLength":7,"maxLength":40}},"description":"Optional buyer prefill; never an authenticated customer identity."},"external_reference":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"}}},"Phase4WebhookEvent":{"type":"object","additionalProperties":false,"required":["id","type","api_version","created_at","environment","integration_id","data"],"properties":{"id":{"type":"string","format":"uuid"},"type":{"enum":["order.created","order.paid","group.admissions_reserved","ticket.issued","ticket.checked_in","refund.completed"]},"api_version":{"const":"2026-10-16"},"created_at":{"type":"string","format":"date-time"},"environment":{"enum":["test","live"]},"integration_id":{"type":"string","format":"uuid"},"data":{"type":"object","additionalProperties":false,"required":["checkout_session_id","order_id","event_id"],"properties":{"checkout_session_id":{"type":"string","format":"uuid"},"order_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"amount_kobo":{"type":"integer","minimum":0},"currency":{"const":"NGN"},"group_booking_id":{"type":"string","format":"uuid"},"admissions":{"type":"integer","minimum":2,"maximum":400},"ticket_id":{"type":"string","format":"uuid"},"checked_in_at":{"type":"string","format":"date-time"},"refund_id":{"type":"string","format":"uuid"}}}}},"Phase5Event":{"type":"object","additionalProperties":false,"required":["id","title","slug","description","image_url","venue","starts_at","ends_at","timezone","sales_start_at","sales_end_at","organiser","category"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"image_url":{"type":["string","null"]},"venue":{"type":"object","additionalProperties":false,"required":["name","address","city","state"],"properties":{"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"}}},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"timezone":{"type":"string"},"sales_start_at":{"type":["string","null"],"format":"date-time"},"sales_end_at":{"type":["string","null"],"format":"date-time"},"organiser":{"type":"object","additionalProperties":false,"required":["id","name","verified"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"verified":{"type":"boolean"}}},"category":{"type":"object","additionalProperties":false,"required":["id","name","slug"],"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"}}}}},"Phase5WidgetTicketType":{"type":"object","additionalProperties":false,"required":["id","event_id","name","description","currency","price_kobo","standard_price_kobo","price_kind","early_bird_price_kobo","early_bird_ends_at","admissions_per_ticket","min_packages_per_order","max_packages_per_order","sales_start_at","sales_end_at","sale_status","fees_included","promo_discount_included","max_packages_available"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"name":{"type":"string"},"description":{"type":["string","null"]},"currency":{"const":"NGN","type":"string"},"price_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"standard_price_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"price_kind":{"type":"string","enum":["standard","early_bird"]},"early_bird_price_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"early_bird_ends_at":{"type":["string","null"],"format":"date-time"},"admissions_per_ticket":{"type":"integer","minimum":1},"min_packages_per_order":{"type":"integer","minimum":0,"maximum":9007199254740991},"max_packages_per_order":{"type":"integer","minimum":0,"maximum":9007199254740991},"sales_start_at":{"type":["string","null"],"format":"date-time"},"sales_end_at":{"type":["string","null"],"format":"date-time"},"sale_status":{"type":"string","enum":["open","upcoming","closed","sold_out","allocation_limited"]},"fees_included":{"const":false,"type":"boolean"},"promo_discount_included":{"const":false,"type":"boolean"},"max_packages_available":{"type":"integer","minimum":0,"maximum":20,"description":"Advisory packages available at current price, clipped to the per-selection cap; rechecked on reservation."}}},"Phase5WidgetSnapshot":{"type":"object","additionalProperties":false,"properties":{"widget_id":{"type":"string","pattern":"^nt_widget_[a-f0-9]{32}$"},"environment":{"type":"string","enum":["test","live"]},"checkout_enabled":{"type":"boolean","description":"Organiser grant only; HTML additionally checks hosted server configuration."},"event":{"$ref":"#/components/schemas/Phase5Event"},"tickets":{"type":"array","maxItems":100,"items":{"$ref":"#/components/schemas/Phase5WidgetTicketType"}}},"required":["widget_id","environment","checkout_enabled","event","tickets"]},"Phase5WidgetSettings":{"type":"object","additionalProperties":false,"properties":{"environment":{"type":"string","enum":["test","live"]},"enabled":{"type":"boolean"},"checkoutEnabled":{"type":"boolean"},"revision":{"type":"integer","minimum":0},"widgetOrigin":{"type":"string","format":"uri"}},"required":["environment","enabled","checkoutEnabled","revision","widgetOrigin"]},"Phase5WidgetUpdate":{"type":"object","additionalProperties":false,"properties":{"environment":{"type":"string","enum":["test","live"]},"enabled":{"type":"boolean"},"checkoutEnabled":{"type":"boolean"}},"required":["environment","enabled","checkoutEnabled"]},"Phase5PublicError":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]}},"required":["error"]},"Phase6Order":{"type":"object","additionalProperties":false,"required":["id","event_id","checkout_session_id","status","currency","subtotal_kobo","discount_kobo","fee_kobo","total_kobo","created_at","paid_at","payment_status","admissions"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"checkout_session_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","paid","failed","abandoned","expired","refunded","partially_refunded"]},"currency":{"type":"string","enum":["NGN"]},"subtotal_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"discount_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"fee_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"total_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"created_at":{"type":"string","format":"date-time"},"paid_at":{"type":["string","null"],"format":"date-time"},"payment_status":{"type":"string","enum":["verified","refunded","unverified"]},"admissions":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"Phase6Ticket":{"type":"object","additionalProperties":false,"required":["id","event_id","order_id","ticket_type_id","group_booking_id","status","claim_state","issued_at","claimed_at","checked_in_at","admission_limit","admissions_used","usable_for_entry"],"properties":{"id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"order_id":{"type":"string","format":"uuid"},"ticket_type_id":{"type":"string","format":"uuid"},"group_booking_id":{"type":["string","null"],"format":"uuid"},"status":{"type":"string","enum":["valid","used","cancelled","refunded"]},"claim_state":{"type":"string","enum":["UNCLAIMED","CLAIMED","CHECKED_IN"]},"issued_at":{"type":"string","format":"date-time"},"claimed_at":{"type":["string","null"],"format":"date-time"},"checked_in_at":{"type":["string","null"],"format":"date-time"},"admission_limit":{"type":"integer","const":1},"admissions_used":{"type":"integer","minimum":0,"maximum":1},"usable_for_entry":{"type":"boolean"}}},"Phase6Attendee":{"type":"object","additionalProperties":false,"required":["ticket_id","order_id","event_id","group_booking_id","claim_state","ticket_status","personal_data_erased","name"],"properties":{"ticket_id":{"type":"string","format":"uuid"},"order_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"group_booking_id":{"type":["string","null"],"format":"uuid"},"claim_state":{"type":"string","enum":["CLAIMED","CHECKED_IN"]},"ticket_status":{"type":"string","enum":["valid","used","cancelled","refunded"]},"personal_data_erased":{"type":"boolean"},"name":{"type":["string","null"]},"email":{"type":["string","null"],"description":"Present only with attendees:contact in addition to attendees:read; null when erased."},"phone":{"type":["string","null"],"description":"Present only with both attendee permissions; can be null if not collected or erased."}}},"Phase6Group":{"type":"object","additionalProperties":false,"required":["id","order_id","event_id","ticket_type_id","admissions","registered_admissions","unclaimed_admissions","checked_in_admissions","claimable_admissions"],"properties":{"id":{"type":"string","format":"uuid"},"order_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"ticket_type_id":{"type":"string","format":"uuid"},"admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"registered_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"unclaimed_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"checked_in_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"claimable_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"Phase6Refund":{"type":"object","additionalProperties":false,"required":["id","order_id","status","amount_kobo","currency","created_at","confirmed_at"],"properties":{"id":{"type":"string","format":"uuid"},"order_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["requested","approved","rejected","processing","completed","failed"]},"amount_kobo":{"type":["integer","null"],"minimum":0,"maximum":9007199254740991},"currency":{"type":"string","enum":["NGN"]},"created_at":{"type":"string","format":"date-time"},"confirmed_at":{"type":["string","null"],"format":"date-time"}}},"Phase6Sales":{"type":"object","additionalProperties":false,"required":["event_id","currency","verified_orders","ticket_subtotal_kobo","service_fees_charged_kobo","customer_payments_kobo","completed_refunds_kobo","net_customer_payments_kobo","sold_admissions","as_of","application_attributed_only"],"properties":{"event_id":{"type":["string","null"],"format":"uuid"},"currency":{"type":"string","enum":["NGN"]},"verified_orders":{"type":"integer","minimum":0,"maximum":9007199254740991},"ticket_subtotal_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"service_fees_charged_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"customer_payments_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"completed_refunds_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"net_customer_payments_kobo":{"type":"integer","minimum":0,"maximum":9007199254740991},"sold_admissions":{"type":"integer","minimum":0,"maximum":9007199254740991},"as_of":{"type":"string","format":"date-time"},"application_attributed_only":{"type":"boolean","const":true}}},"Phase6EntryResult":{"type":"object","additionalProperties":false,"required":["ticket_id","event_id","outcome","admitted","admission_limit","admissions_used","checked_in_at","replayed"],"properties":{"ticket_id":{"type":"string","format":"uuid"},"event_id":{"type":"string","format":"uuid"},"outcome":{"type":"string","enum":["valid","admitted","already_used","cancelled","refunded","unpaid","invalid","event_unavailable"]},"admitted":{"type":"boolean"},"admission_limit":{"type":"integer","const":1},"admissions_used":{"type":"integer","minimum":0,"maximum":1},"checked_in_at":{"type":["string","null"],"format":"date-time"},"replayed":{"type":"boolean"}}},"Phase6EntryInput":{"type":"object","additionalProperties":false,"required":["code","action"],"properties":{"code":{"type":"string","pattern":"^NT-[A-F0-9]{12}$"},"action":{"type":"string","enum":["verify","admit"]}}},"Phase6Error":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string","format":"uuid"}}}}},"Phase8ExternalEventInput":{"type":"object","required":["title","starts_at","ends_at","tickets"],"properties":{"title":{"type":"string","minLength":2,"maxLength":160},"presenter_line":{"type":"string","maxLength":160},"description":{"type":"string","maxLength":2000},"venue_name":{"type":"string","maxLength":160},"address":{"type":"string","maxLength":300},"city":{"type":"string","maxLength":80},"state":{"type":"string","maxLength":80},"timezone":{"type":"string","example":"Africa/Lagos"},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":"string","format":"date-time"},"sales_start_at":{"type":"string","format":"date-time"},"sales_end_at":{"type":"string","format":"date-time"},"image_url":{"type":"string","format":"uri"},"source_url":{"type":"string","format":"uri"},"tickets":{"type":"array","minItems":1,"maxItems":20,"items":{"$ref":"#/components/schemas/Phase8ExternalTicketInput"}}}},"Phase8ExternalTicketInput":{"type":"object","required":["external_id","name","price_kobo","quantity"],"properties":{"external_id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,100}$"},"name":{"type":"string","minLength":2,"maxLength":120},"description":{"type":"string"},"price_kobo":{"type":"integer","minimum":0,"description":"NGN kobo: ₦45,000 is 4500000."},"quantity":{"type":"integer","minimum":0,"maximum":100000,"description":"Number of ticket packages for sale."},"admissions_per_ticket":{"type":"integer","minimum":1,"maximum":100,"default":1},"min_per_order":{"type":"integer","minimum":1,"maximum":20,"default":1},"max_per_order":{"type":"integer","minimum":1,"maximum":20,"default":10}}},"Phase8ExternalEventResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["id","external_id","title","status"],"properties":{"id":{"type":"string","format":"uuid","description":"Backing event ID for the widget or checkout-session API."},"external_id":{"type":"string"},"title":{"type":"string"},"status":{"type":"string","enum":["published"]}}},"meta":{"type":"object"}}}},"securitySchemes":{"Phase3IntegrationSecret":{"type":"http","scheme":"bearer","bearerFormat":"nt_test_<id>_<secret> or nt_live_<id>_<secret>","description":"Requires integration:read. Credentials are secret server keys, not widget identifiers."},"Phase4OrganiserJWT":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"Phase4SchedulerSecret":{"type":"http","scheme":"bearer"},"Phase5OrganiserJWT":{"type":"http","scheme":"bearer","bearerFormat":"Supabase user JWT"},"Phase6ServerAPIKey":{"type":"http","scheme":"bearer","bearerFormat":"nt_test_… or nt_live_… server secret; never a widget ID or browser token"},"Phase8IntegrationKey":{"type":"http","scheme":"bearer","bearerFormat":"nt_test_ or nt_live_ server key"}}},"webhooks":{"eventNotification":{"post":{"summary":"Receive a signed Naija Tickets event","description":"Configure the receiver in the organiser dashboard. Verify the exact raw body, ID and timestamp with the dedicated endpoint secret; durably deduplicate the event ID before acknowledging. At-least-once delivery; daily Hobby dispatch has no prompt-delivery guarantee.","security":[],"parameters":[{"name":"naija-webhook-id","in":"header","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"naija-webhook-timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]{10}$"}},{"name":"naija-webhook-signature","in":"header","required":true,"schema":{"type":"string","pattern":"^v1=[a-f0-9]{64}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Phase4WebhookEvent"}}}},"responses":{"200":{"description":"Signature accepted and event durably recorded/deduplicated."},"401":{"description":"Invalid signature or expired timestamp."},"409":{"description":"Conflicting event identity/body."},"503":{"description":"Durable inbox unavailable; do not acknowledge."}}}}}}