FORMAT: 1A HOST: https://openapi.eventii.dk/v1 # eventii Open API The eventii Open API provides programmatic access to the eventii ticketing platform. Manage customers, events, tickets, season tickets, partners, webhooks, and more. ## Authentication All requests require an API key passed via the `X-API-KEY` header. ``` X-API-KEY: your-api-key-here ``` Each API key has scoped permissions (e.g. `Customers:Read`, `Tickets:Update`). Contact eventii to obtain an API key with the scopes your integration requires. ## Rate Limiting Most endpoints limit an API key to **100 requests per 60 seconds**. Operation-specific limits apply where documented; starting a historical sync is limited to **10 requests per 60 seconds**, while retrieving its status is limited to **60 requests per 60 seconds**. Exceeding a limit returns `429 Too Many Requests`. ## Response Format Most successful responses are wrapped in a standard envelope: ```json { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Mette" } } ``` Paginated responses include pagination metadata: ```json { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 1, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Mette" } ] } ``` Historical synchronization operations return their run status object directly, rather than this envelope. ## Synchronising data For the first load, walk `/sync/customers` and `/sync/partners` using the returned `nextCursor` as the next request's `cursor` until `nextCursor` is null. For customers, run a daily sync with `updatedSince` set to the start time of the previous run minus 5 minutes. Walk each run by cursor and upsert records by `id`. Season tickets (`/seasoncards/query`), subscriptions (`/subscriptions`) and subscription payments (`/subscriptions/payments`) sync with a change token instead: start with `changedSince=0000000000000000`, continue with the last row's `changeToken`, and store the last token for the next run, so each run fetches only what changed. Use `CustomerCreated`, `CustomerUpdated`, `CustomerDeleted`, and the season card and ticket webhook events for near real time changes. Avoid fetching whole clubs every day. For partners, use `createdFrom` to find new records and a periodic full walk to pick up changes. ## Error Responses Many errors follow this standard format; check each operation's documented status responses because synchronization operations return a run status object directly: ```json { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": ["'Id' must not be empty."] } ``` # Group Accounts Manage user accounts in the identity system. Create accounts, validate credentials, and change passwords. ## Account [/accounts/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Account ID (GUID) ### Get Account [GET] Retrieve an account by ID. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (AccountResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "username": "john.doe@example.com", "entities": [ { "type": "Customer", "value": "4fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "loginLink": "https://shop.example.com/login?token=example-token" } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Entity of type Account with id 3fa85f64-5717-4562-b3fc-2c963f66afa6 was not found"] } ## Account By Username [/accounts/username/{Username}] + Parameters + Username: `john.doe@example.com` (string, required) - Username (typically an email) ### Get Account By Username [GET] Retrieve an account by username. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (IdentityResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "email": "john.doe@example.com", "normalizedEmail": "JOHN.DOE@EXAMPLE.COM", "userName": "john.doe@example.com", "normalizedUserName": "JOHN.DOE@EXAMPLE.COM", "lockoutEnabled": false, "lockoutEnd": null } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Account with username john.doe@example.com was not found"] } ## Account Collection [/accounts] ### Create Account [POST] Create a new account in the identity system. + Request (application/json) + Attributes (CreateAccountRequest) + Headers X-API-KEY: your-api-key-here + Body { "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phoneNumber": "12345678", "address": "Vestergade 1", "city": "København", "postalCode": "1456", "country": "Danmark", "company": "", "vatNumber": "", "birthday": "1990-01-01T00:00:00Z", "gender": "Male", "password": "SecureP@ss1", "passwordConfirmation": "SecureP@ss1", "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } + Response 200 (application/json) + Attributes (AccountResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "username": "john.doe@example.com", "entities": [ { "type": "Customer", "value": "4fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "loginLink": "https://shop.example.com/login?token=example-token" } } + Response 409 (application/json) { "statusCode": 409, "isSuccess": false, "errorMessage": "conflict", "errors": ["An account with this email already exists"] } ## Validate Credentials [/accounts/validatecredentials] ### Validate Credentials [POST] Validate username and password combination. + Request (application/json) + Attributes (ValidateCredentialsRequest) + Headers X-API-KEY: your-api-key-here + Body { "username": "john.doe@example.com", "password": "SecureP@ss1" } + Response 200 (application/json) + Attributes (AccountResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "username": "john.doe@example.com", "entities": [ { "type": "Customer", "value": "4fa85f64-5717-4562-b3fc-2c963f66afa6" } ], "loginLink": "https://shop.example.com/login?token=example-token" } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Invalid credentials"] } ## Change Password [/accounts/changepassword] ### Change Password [POST] Change an account's password. Password must contain at least 8 characters, one letter, one digit, and one special character. + Request (application/json) + Attributes (ChangePasswordRequest) + Headers X-API-KEY: your-api-key-here + Body { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "currentPassword": "OldP@ss1", "newPassword": "NewP@ss2" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Account not found"] } # Group API Keys Retrieve information about API keys. ## API Key [/apikeys] ### Get API Key [GET] Retrieve details about the current API key including its scopes. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (ApiKeyResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "issuedTo": "Partner Integration", "issuedBy": "admin@eventii.dk", "issuedAtUtc": "2024-01-01T00:00:00Z", "expiresAtUtc": "2025-12-31T23:59:59Z", "tenantId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "tenantName": "Viborg FF", "scopes": [ { "scope": "Customers", "create": false, "read": true, "update": false, "delete": false }, { "scope": "Tickets", "create": false, "read": true, "update": false, "delete": false }, { "scope": "SeasonCards", "create": false, "read": true, "update": false, "delete": false } ] } } # Group Customers Manage customer data, consents, and loyalty. ## Customer [/customers/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Customer ID (GUID) ### Get Customer [GET] Retrieve a customer by ID. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (CustomerResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "email": "john.doe@example.com", "phone": "+4512345678", "company": null, "cvrNumber": null, "birthday": "1990-01-01T00:00:00Z", "gender": "Male", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "country": "Danmark", "subjectId": "auth0|abc123", "anonymized": null, "anonymizedBy": null, "customFieldValue": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "availableLoyaltyPoints": 150 } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Entity of type Customer with id 3fa85f64-5717-4562-b3fc-2c963f66afa6 was not found"] } ## Consent Types [/customers/consenttypes] ### Get Consent Types [GET] Retrieve all available consent types. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (ConsentTypesResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "marketing_email", "description": "Permission to send marketing emails", "displayName": "Email Marketing", "isRequired": false, "termsLink": "https://example.com/terms" } ] } ## Consent Type [/customers/consent] ### Create Consent Type [POST] Create a new consent type. **Required scope:** `Customers:Create` + Request (application/json) + Attributes (CreateConsentTypeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "marketing_email", "description": "Permission to send marketing emails", "displayName": "Email Marketing", "isRequired": false, "termsLink": "https://example.com/terms" } + Response 200 (application/json) + Attributes (ConsentTypeResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "marketing_email", "description": "Permission to send marketing emails", "displayName": "Email Marketing", "isRequired": false, "termsLink": "https://example.com/terms" } } ## Consent Type Update [/customers/consent/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Consent Type ID (GUID) ### Update Consent Type [PUT] Update an existing consent type. **Required scope:** `Customers:Update` + Request (application/json) + Attributes (UpdateConsentTypeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "marketing_email", "description": "Updated description", "displayName": "Email Marketing Updated", "isRequired": false, "termsLink": "https://example.com/terms-v2" } + Response 200 (application/json) + Attributes (EmptyObjectResult) { "statusCode": 200, "isSuccess": true, "result": {} } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Consent type not found"] } ## Customer Consents [/customers/{id}/consents] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Customer ID (GUID) ### Get Customer Consents [GET] Retrieve all consents for a customer. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (CustomerConsentsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "consentTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "consentTypeName": "marketing_email", "grantedTimestamp": "2024-06-01T12:00:00Z", "grantedBy": "customer", "revokedTimestamp": null, "revokedBy": null } ] } ## Grant Consent [/customers/{CustomerId}/consent/grant/{ConsentTypeId}] + Parameters + CustomerId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Customer ID (GUID) + ConsentTypeId: `4fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Consent Type ID (GUID) ### Grant Consent [POST] Grant a consent type for a customer. **Required scope:** `Customers:Update` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (ConsentActionResult) { "statusCode": 200, "isSuccess": true, "result": null } ## Revoke Consent [/customers/{CustomerId}/consent/revoke/{ConsentTypeId}] + Parameters + CustomerId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Customer ID (GUID) + ConsentTypeId: `4fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Consent Type ID (GUID) ### Revoke Consent [POST] Revoke a consent type for a customer. **Required scope:** `Customers:Update` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (ConsentActionResult) { "statusCode": 200, "isSuccess": true, "result": null } ## Customers With Consent [/customers/consents/{ConsentTypeId}] + Parameters + ConsentTypeId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Consent Type ID (GUID) ### Get Customers With Consent [GET] Retrieve all customers who have granted a specific consent type. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (CustomersWithConsentResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "country": "Danmark", "email": "john.doe@example.com", "phone": "+4512345678", "consentName": "marketing_email", "grantedBy": "customer", "grantedTimestamp": "2024-06-01T12:00:00Z" } ] } # Group Events Manage events and event types. ## Events Collection [/events] ### Get Events [GET] Retrieve all events. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (EventsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "displayName": "VFF vs OB", "matchId": 12345, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "openTime": "2024-09-15T16:00:00Z", "eventText": "Superliga Round 8", "eventTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "eventTypeName": "Superliga", "imageUrl": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "homeTeamLogoUrl": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "awayLogoTeamLogoUrl": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "venueId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" } ] } ## Event [/events/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID (GUID) ### Get Event [GET] Retrieve an event by ID. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (EventResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "displayName": "VFF vs OB", "matchId": 12345, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "openTime": "2024-09-15T16:00:00Z", "eventText": "Superliga Round 8", "eventTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "eventTypeName": "Superliga", "imageUrl": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "homeTeamLogoUrl": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "awayLogoTeamLogoUrl": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "venueId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Entity of type Event with id 3fa85f64-5717-4562-b3fc-2c963f66afa6 was not found"] } ## Event Types Collection [/eventtypes] ### Get Event Types [GET] Retrieve all event types. **Required scope:** `Events:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (EventTypesResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Superliga", "description": "Danish Superliga matches" } ] } ### Create Event Type [POST] Create a new event type. **Required scope:** `Events:Create` + Request (application/json) + Attributes (CreateEventTypeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Superliga", "description": "Danish Superliga matches" } + Response 200 (application/json) + Attributes (EventTypeResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Superliga", "description": "Danish Superliga matches" } } ## Event Type [/eventtypes/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event Type ID (GUID) ### Get Event Type [GET] Retrieve a single event type by ID. **Required scope:** `Events:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (EventTypeResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Superliga", "description": "Danish Superliga matches" } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Event type not found"] } ### Update Event Type [PUT] Update an existing event type. **Required scope:** `Events:Update` + Request (application/json) + Attributes (UpdateEventTypeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Superliga Updated", "description": "Updated description" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Event type not found"] } # Group Tickets Manage tickets including retrieval, forwarding, and releasing. ## Ticket [/tickets/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Ticket ID (GUID) ### Get Ticket [GET] Retrieve a ticket by ID. **Required scope:** `Tickets:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (TicketResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "status": "Active", "deliveryType": "Digital", "expirationTime": "2024-09-15T22:00:00Z", "buyerInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "eventInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "description": null, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "gatesOpenTime": "2024-09-15T16:00:00Z", "venueId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" }, "seatingInfo": { "sectionId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 1", "seatId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "orderInfo": { "id": "afa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "txn_abc123", "faceValue": 150, "deliveryPrice": 0, "totalPrice": 150, "priceCategoryId": "bfa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "events": [ { "type": "Sent", "timeStamp": "2024-08-01T10:00:00Z", "message": "Ticket sent to jens.hansen@example.com" } ], "pdfLink": "https://api.eventii.dk/tickets/3fa85f64-5717-4562-b3fc-2c963f66afa6/pdf", "appleWalletLink": "https://applewallet.com/pass123", "googlePayLink": "https://googlewallet.com/pass123" } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Ticket not found"] } ## Tickets By Buyer [/tickets/buyer/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Buyer ID (GUID) ### Get Tickets By Buyer [GET] Retrieve all tickets purchased by a buyer. **Required scope:** `Tickets:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (TicketsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "status": "Active", "deliveryType": "Digital", "expirationTime": "2024-09-15T22:00:00Z", "buyerInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "eventInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "description": null, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "gatesOpenTime": "2024-09-15T16:00:00Z", "venueId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" }, "seatingInfo": { "sectionId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 1", "seatId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "orderInfo": { "id": "afa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "txn_abc123", "faceValue": 150, "deliveryPrice": 0, "totalPrice": 150, "priceCategoryId": "bfa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "events": [], "pdfLink": "", "appleWalletLink": "", "googlePayLink": "" } ] } ## Tickets By Holder [/tickets/holder/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Holder ID (GUID) ### Get Tickets By Holder [GET] Retrieve all tickets held by a person (only tickets currently on their profile). **Required scope:** `Tickets:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (TicketsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "status": "Active", "deliveryType": "Digital", "expirationTime": "2024-09-15T22:00:00Z", "buyerInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "eventInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "description": null, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "gatesOpenTime": "2024-09-15T16:00:00Z", "venueId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" }, "seatingInfo": { "sectionId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 1", "seatId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "orderInfo": { "id": "afa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "txn_abc123", "faceValue": 150, "deliveryPrice": 0, "totalPrice": 150, "priceCategoryId": "bfa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "events": [], "pdfLink": "", "appleWalletLink": "", "googlePayLink": "" } ] } ## Forward Ticket [/tickets/{id}/forward] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Ticket ID (GUID) ### Forward Ticket [POST] Forward a ticket to another person via email. **This action cannot be undone.** **Required scope:** `Tickets:Update` + Request (application/json) + Attributes (ForwardTicketRequest) + Headers X-API-KEY: your-api-key-here + Body { "email": "recipient@example.com" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Ticket not found"] } ## Release Ticket [/tickets/{id}/release] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Ticket ID (GUID) ### Release Ticket [POST] Release a ticket for resale. **This action cannot be undone.** **Required scope:** `Tickets:Update` + Request + Headers X-API-KEY: your-api-key-here + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Ticket not found"] } # Group Season Tickets Manage season tickets including retrieval, forwarding, releasing, and issuing as tickets. ## Season Ticket [/seasoncards/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Season Ticket ID (GUID) ### Get Season Ticket [GET] Retrieve a season ticket by ID. **Required scope:** `SeasonCards:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SeasonCardResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "cardHolder": "Jens Hansen", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "status": "Active", "deliveryType": "Digital", "validFrom": "2024-07-01T00:00:00Z", "expirationTime": "2025-06-30T23:59:59Z", "holderBirthday": "1990-01-15T00:00:00Z", "buyerInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "orderInfo": { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "2fa85f64-5717-4562-b3fc-2c963f66afa6", "faceValue": 2500, "deliveryPrice": 0, "totalPrice": 2500, "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "seatingInfo": { "sectionId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 6", "seatId": "afa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "appleWalletLink": "https://applewallet.com/pass123", "googlePayLink": "https://googlewallet.com/pass123", "validEvents": [ { "id": "bfa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "startTime": "2024-09-15T18:00:00Z", "releaseStartTime": "2024-09-10T00:00:00Z", "releaseEndTime": "2024-09-14T23:59:59Z", "issueTicketStartTime": "2024-09-10T00:00:00Z", "issueTicketEndTime": "2024-09-14T23:59:59Z", "venueId": "cfa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion", "venueStreet": "Stadionvej 1", "venueCity": "Vejle", "venueZipCode": "7100", "venueCountry": "Danmark", "venueLongitude": 9.5357, "venueLatitude": 55.7113 } ], "releaseEvents": [ { "eventId": "dfa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "VFF - FCK", "eventTime": "2024-08-20T18:00:00Z", "releasedBy": "jens.hansen@example.com", "timestamp": "2024-08-15T10:30:00Z" } ], "cardTickets": [ { "ticketId": "efa85f64-5717-4562-b3fc-2c963f66afa6", "orderId": "ffa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725600", "issuedTo": "friend@example.com", "eventId": "bfa85f64-5717-4562-b3fc-2c963f66afa7", "eventName": "VFF - BIF", "eventTime": "2024-09-01T18:00:00Z", "timestamp": "2024-08-28T14:00:00Z" } ], "logEvents": [ { "eventType": "Released", "eventId": "dfa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "VFF - FCK", "message": "Season ticket was released for event VFF - FCK (dfa85f64-5717-4562-b3fc-2c963f66afa6)" }, { "eventType": "SentAsTicket", "eventId": "bfa85f64-5717-4562-b3fc-2c963f66afa7", "eventName": "VFF - BIF", "message": "Season ticket was sent as ticket to friend@example.com for event VFF - BIF (bfa85f64-5717-4562-b3fc-2c963f66afa7)" } ], "isSubscription": false } } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Season ticket not found"] } ## Season Tickets Query [/seasoncards/query{?page,pageSize,seasonCardTypeId,priceCategoryId,includeCancelled,includeExpired,changedSince}] + Parameters + page: `1` (integer, optional) - Page number (default: 1); ignored with changedSince. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. + seasonCardTypeId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Filter by season ticket type + priceCategoryId: `4fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Filter by price category + includeCancelled: `false` (boolean, optional) - Include cancelled season tickets + includeExpired: `false` (boolean, optional) - Include expired season tickets + changedSince: `0000000000001F3A` (string, optional) - Return changes after this opaque token. Must be exactly 16 hexadecimal characters, case insensitive; invalid format returns `400 Bad Request`. ### Query Season Tickets [GET] Paginated query of season tickets with optional filters. A `pageSize` outside 1 to 100 returns `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. Without `changedSince`, existing pagination and status filters are unchanged. Every season ticket returned here includes `changeToken`, `isDeleted`, `previousCardId`, `nextCardId`, `scans` and `events`. The opaque `changeToken` has 16 hexadecimal characters. Follow `previousCardId` and `nextCardId` to walk a holder's seasons through renewals; either link can be null. `scans` counts usage events before today where the season ticket or a ticket issued from it was scanned. `events` counts usage events before today for which the season ticket was valid, meaning its seat was not released or a ticket issued from it is active. Both counts are nullable. **Keep a copy in sync** 1. Start with `changedSince=0000000000000000` to load the initial copy. 2. Apply each page, removing season tickets with `isDeleted` set to true. Request the next page using the last season ticket's `changeToken` as `changedSince`, until a page has fewer rows than `pageSize`. 3. Store the last token and continue from it on every later run. If a page is empty, keep the current token. * With `changedSince`, every status is returned, oldest change first. `page` is ignored and `resultSize` is the number of rows on this page. Paging without `changedSince` can miss changes. * Soft deleted season tickets are returned once with `isDeleted` set to true as the token advances. Season tickets of a deleted season ticket type are not returned. * The token moves when the season ticket itself changes. `scans`, `events`, `validEvents`, `releaseEvents`, `cardTickets`, `devices` and `nextCardId` reflect the time of the read. A change to them alone, such as a release, an issued ticket or a device change, does not return the season ticket again. * Sync without `seasonCardTypeId` or `priceCategoryId`. A season ticket that moves out of either filter is not reported. Example request: `GET /seasoncards/query?page=1&pageSize=50&includeCancelled=false&includeExpired=false&changedSince=0000000000000000`. To continue after the example response below, request `GET /seasoncards/query?pageSize=50&changedSince=0000000000001F3A`. **Required scope:** `SeasonCards:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SeasonCardsPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 1, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "cardHolder": "Jens Hansen", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "status": "Active", "deliveryType": "Digital", "validFrom": "2024-07-01T00:00:00Z", "expirationTime": "2025-06-30T23:59:59Z", "holderBirthday": "1990-01-15T00:00:00Z", "buyerInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": "123456", "externalIds": null, "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "orderInfo": { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "2fa85f64-5717-4562-b3fc-2c963f66afa6", "faceValue": 2500, "deliveryPrice": 0, "totalPrice": 2500, "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "seatingInfo": { "sectionId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 6", "seatId": "afa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "appleWalletLink": "", "googlePayLink": "", "validEvents": [], "releaseEvents": [], "cardTickets": [], "logEvents": [], "isSubscription": false, "changeToken": "0000000000001F3A", "isDeleted": false, "previousCardId": null, "nextCardId": null, "scans": 12, "events": 15 } ] } ## Season Tickets By Buyer [/seasoncards/buyer/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Buyer ID (GUID) ### Get Season Tickets By Buyer [GET] Retrieve all season tickets purchased by a buyer, including tickets that have been forwarded to others. **Required scope:** `SeasonCards:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SeasonCardsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "cardHolder": "Jens Hansen", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "status": "Active", "deliveryType": "Digital", "validFrom": "2024-07-01T00:00:00Z", "expirationTime": "2025-06-30T23:59:59Z", "holderBirthday": "1990-01-15T00:00:00Z", "buyerInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "orderInfo": { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "2fa85f64-5717-4562-b3fc-2c963f66afa6", "faceValue": 2500, "deliveryPrice": 0, "totalPrice": 2500, "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "seatingInfo": { "sectionId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 6", "seatId": "afa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "appleWalletLink": "", "googlePayLink": "", "validEvents": [], "releaseEvents": [], "cardTickets": [], "logEvents": [], "isSubscription": false } ] } ## Season Tickets By Holder [/seasoncards/holder/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Holder ID (GUID) ### Get Season Tickets By Holder [GET] Retrieve all season tickets held by a person (only tickets currently on their profile). **Required scope:** `SeasonCards:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SeasonCardsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "cardHolder": "Jens Hansen", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "status": "Active", "deliveryType": "Digital", "validFrom": "2024-07-01T00:00:00Z", "expirationTime": "2025-06-30T23:59:59Z", "holderBirthday": "1990-01-15T00:00:00Z", "buyerInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "Male", "birthDate": "1990-01-15T00:00:00Z" }, "orderInfo": { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "2fa85f64-5717-4562-b3fc-2c963f66afa6", "faceValue": 2500, "deliveryPrice": 0, "totalPrice": 2500, "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "seatingInfo": { "sectionId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 6", "seatId": "afa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "appleWalletLink": "", "googlePayLink": "", "validEvents": [], "releaseEvents": [], "cardTickets": [], "logEvents": [], "isSubscription": false } ] } ## Forward Season Ticket [/seasoncards/{id}/forward] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Season Ticket ID (GUID) ### Forward Season Ticket [POST] Forward an entire season ticket to another person via email. **This action cannot be undone.** The ticket will be transferred from the current holder's profile to the recipient. **Required scope:** `SeasonCards:Update` + Request (application/json) + Attributes (ForwardSeasonCardRequest) + Headers X-API-KEY: your-api-key-here + Body { "email": "recipient@example.com" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Season ticket not found"] } ## Release Season Ticket [/seasoncards/{id}/release] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Season Ticket ID (GUID) ### Release Season Ticket [POST] Release a season ticket for a specific event so the seat can be resold. **This action cannot be undone.** Only allowed within the event's release time window (`releaseStartTime` to `releaseEndTime`). **Required scope:** `SeasonCards:Update` + Request (application/json) + Attributes (ReleaseSeasonCardRequest) + Headers X-API-KEY: your-api-key-here + Body { "eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } + Response 204 + Response 400 (application/json) { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": ["Release window is not open for this event"] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Season ticket not found"] } ## Send Season Ticket As Ticket [/seasoncards/{id}/ticket] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Season Ticket ID (GUID) ### Send As Ticket [POST] Issue a ticket from the season ticket for a specific event and send it to a recipient. Only allowed within the event's ticket issuance window (`issueTicketStartTime` to `issueTicketEndTime`). A season ticket can only issue one ticket per event. Business-error responses with status 400 or 409 return the serialized `BadRequestException` shape documented as `SeasonCardTicketError`, instead of the standard error envelope. These bodies include the internal exception type in `message` and have no `statusCode` or `isSuccess` fields. The exceptions are newly constructed and never thrown, so `targetSite`, `innerException`, `helpLink`, `source` and `stackTrace` are null and `data` is empty. A missing `X-API-KEY` header and request validation failures use problem details; authorization failures return the standard 401 error envelope. **Required scope:** `SeasonCards:Update` + Request (application/json) + Attributes (SendSeasonCardAsTicketRequest) + Headers X-API-KEY: your-api-key-here + Body { "eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "recipient": "friend@example.com" } + Response 204 + Response 400 (application/json) + Attributes (SeasonCardTicketError) **Outside ticket issuance window** - The event is not in the ticket issuance window. { "errorMessage": "bad request", "errors": ["Event is not in issue ticket window"], "targetSite": null, "message": "Exception of type 'ticketing.open.api.Core.Exceptions.BadRequestException' was thrown.", "data": {}, "innerException": null, "helpLink": null, "source": null, "hResult": -2146233088, "stackTrace": null } + Response 409 (application/json) + Attributes (SeasonCardTicketError) **Ticket already issued** - A ticket has already been issued for the event. { "errorMessage": "bad request", "errors": ["Ticket is already issued for event"], "targetSite": null, "message": "Exception of type 'ticketing.open.api.Core.Exceptions.BadRequestException' was thrown.", "data": {}, "innerException": null, "helpLink": null, "source": null, "hResult": -2146233088, "stackTrace": null } + Response 409 (application/json) + Attributes (SeasonCardTicketError) **Season card already released** - The season ticket has already been released for the event. { "errorMessage": "bad request", "errors": ["Season ticket is already released for event"], "targetSite": null, "message": "Exception of type 'ticketing.open.api.Core.Exceptions.BadRequestException' was thrown.", "data": {}, "innerException": null, "helpLink": null, "source": null, "hResult": -2146233088, "stackTrace": null } # Group Subscriptions Ticket subscriptions per buyer, and sync of all season ticket and ticket subscriptions with their payments. ## Buyer Ticket Subscriptions [/subscriptions/tickets/buyer/{BuyerId}] + Parameters + BuyerId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Buyer ID (GUID) ### Get Buyer Ticket Subscriptions [GET] Retrieve all ticket subscriptions for a buyer. **Required scope:** `Subscriptions:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (TicketSubscriptionsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Active", "deliveryType": "Digital", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Billetabonnement 2024/25", "validFrom": "2024-07-01T00:00:00Z", "expirationTime": "2025-06-30T23:59:59Z", "birthDate": "1990-01-15T00:00:00Z", "buyerInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "None", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "None", "birthDate": "1990-01-15T00:00:00Z" }, "orderInfo": { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "2fa85f64-5717-4562-b3fc-2c963f66afa6", "faceValue": 2500, "deliveryPrice": 0, "totalPrice": 2500, "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "tickets": [ { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "status": "Active", "deliveryType": "Digital", "expirationTime": "2024-09-15T22:00:00Z", "eventInfo": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "description": null, "startTime": "2024-09-15T18:00:00Z", "endTime": "2024-09-15T20:00:00Z", "gatesOpenTime": "2024-09-15T16:00:00Z", "venueId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "venueName": "Vejle Stadion" }, "seatingInfo": { "sectionId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "tribune": "Nord", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 1", "seatId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "seatNumber": "15", "rowNumber": "3", "isNumbered": true }, "orderInfo": { "id": "afa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "transactionId": "txn_abc123", "faceValue": 150, "deliveryPrice": 0, "totalPrice": 150, "priceCategoryId": "bfa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen" }, "appleWalletLink": "", "googlePayLink": "", "buyerInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "None", "birthDate": "1990-01-15T00:00:00Z" }, "holderInfo": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "externalId": null, "externalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "firstName": "Jens", "lastName": "Hansen", "company": null, "gender": "None", "birthDate": "1990-01-15T00:00:00Z" }, "events": [], "pdfLink": "" } ], "validEvents": [] } ] } ## Subscriptions Sync [/subscriptions{?kind,changedSince,pageSize}] + Parameters + kind: `seasonCard` (string, required) - Subscription kind: `seasonCard` for season ticket subscriptions or `ticket` for ticket subscriptions. Any other value returns `400 Bad Request`. + changedSince: `0000000000000000` (string, required) - Return changes after this opaque token. Must be exactly 16 hexadecimal characters, case insensitive; `0000000000000000` loads everything. Invalid format returns `400 Bad Request`. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Sync Subscriptions [GET] Season ticket subscriptions (`kind=seasonCard`) or ticket subscriptions (`kind=ticket`) of the club, with the customer ID, card type, price category, current amount, status, successful payment count and the latest promoted bulk price change. `kind` is required; sync each kind with its own token. **Keep a copy in sync** 1. Start with `changedSince=0000000000000000` to load the initial copy. 2. Upsert each row by `id`. Request the next page using the last row's `changeToken` as `changedSince`, until a page has fewer rows than `pageSize`. 3. Store the last token and continue from it on every later run. If a page is empty, keep the current token. * Every status is returned (`Active`, `Expired`, `Cancelled`, `Pending`, `Renewal`, `TerminationPending`), oldest change first. Subscriptions are never deleted, only cancelled or terminated. * A subscription is returned again with a new `changeToken` whenever the subscription itself changes, for example its amount, status, termination or a promoted price change. * `cardTypeId`, `cardTypeName`, `priceCategoryId` and `priceCategoryName` are read from the season ticket and its type at the time of the request. Changing or renaming them alone does not return the subscription again; sync again from `0000000000000000` when you need them refreshed. * Changes being saved at the moment of the request appear on a later page, so the newest changes can arrive a little later. * `terminationLocal` is the scheduled end; `cancelledLocal` is when the cancellation was recorded. `latestBulkPriceChange` is null when no price change was promoted for the subscription. * Amounts are minor units (øre), DKK. Fields ending in `Local` are CTS server local wall time (Europe/Copenhagen), ISO 8601 without offset. * `resultSize` is the number of rows on this page. Example request: `GET /subscriptions?kind=seasonCard&changedSince=0000000000000000&pageSize=50`. To continue after the example response below, request `GET /subscriptions?kind=seasonCard&pageSize=50&changedSince=00000000000A41F2`. **Required scope:** `Subscriptions:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SubscriptionsSyncPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 1, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "kind": "seasonCard", "customerId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "cardId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "cardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "cardTypeName": "Sæsonkort 2026/27", "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Voksen", "amountMinor": 22500, "status": "Active", "createdLocal": "2025-06-12T10:15:00", "terminationLocal": null, "cancelledLocal": null, "successfulPaymentCount": 17, "latestBulkPriceChange": { "oldAmountMinor": 19900, "newAmountMinor": 22500, "effectiveFromLocalDate": "2026-07-01", "promotedAtUtc": "2026-06-01T08:00:00Z" }, "changeToken": "00000000000A41F2" } ] } ## Subscription Payments Sync [/subscriptions/payments{?changedSince,kind,subscriptionId,from,toExclusive,pageSize}] + Parameters + changedSince: `0000000000000000` (string, required) - Return changes after this opaque token. Must be exactly 16 hexadecimal characters, case insensitive; `0000000000000000` loads everything. Invalid format returns `400 Bad Request`. + kind: `ticket` (string, optional) - Only payments of `seasonCard` or `ticket` subscriptions. + subscriptionId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Only payments of this subscription, of either kind. + from: `2026-07-01T00:00:00` (string, optional) - Only payments with `timestampLocal` at or after this CTS local time, ISO 8601 with seconds and without offset. + toExclusive: `2026-08-01T00:00:00` (string, optional) - Only payments with `timestampLocal` before this CTS local time, ISO 8601 with seconds and without offset. Must be after `from`. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Sync Subscription Payments [GET] Payment attempts of the club's season ticket and ticket subscriptions. Each row is one attempt with its status (`Accepted`, `Declined` or `Pending`), amount and transaction ID. Together with `GET /subscriptions` this shows what each customer actually paid over time, also across price changes. **Keep a copy in sync** 1. Start with `changedSince=0000000000000000` to load the initial copy. 2. Upsert each row by `id`. Request the next page using the last row's `changeToken` as `changedSince`, until a page has fewer rows than `pageSize`. 3. Store the last token and continue from it on every later run. If a page is empty, keep the current token. * A payment is returned again with a new `changeToken` when it changes, for example from `Pending` to `Accepted`. * `seasonCardSubscriptionId` and `ticketSubscriptionId` link the payment to its subscription; at least one is set, and both can be set. * Changes being saved at the moment of the request appear on a later page, so the newest changes can arrive a little later. * `amountMinor` is minor units (øre), DKK. It is null for payments before 2023-09-19; use the subscription amount as an approximation for those. * `timestampLocal` is the payment time recorded by CTS, set from the payment provider, in CTS server local wall time (Europe/Copenhagen), ISO 8601 without offset. A status change alone does not move it; use `changeToken` to see changes. * `kind`, `subscriptionId`, `from` and `toExclusive` narrow the walk; they do not replace the token. Sync without them to keep a full copy. * `resultSize` is the number of rows on this page. Example request: `GET /subscriptions/payments?changedSince=0000000000000000&pageSize=50`. **Required scope:** `Subscriptions:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SubscriptionPaymentsSyncPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 1, "data": [ { "id": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "ticketSubscriptionId": null, "timestampLocal": "2026-07-01T06:02:11", "status": "Accepted", "amountMinor": 22500, "transactionId": "1234567890", "changeToken": "00000000000A4C07" } ] } # Group Loyalty Retrieve loyalty point balances and activity. ## Loyalty Account [/loyalty/{CustomerId}] + Parameters + CustomerId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Customer ID (GUID) ### Get Loyalty Points [GET] Retrieve loyalty point balance and action history for a customer. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (LoyaltyAccountResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "points": 150, "actions": [ { "barcode": "1234567890123456", "event": "VFF - OB", "expiration": "2025-12-31T23:59:59Z", "name": "Match attendance", "points": 10, "timestamp": "2024-09-15T18:30:00Z", "type": "Earned" } ] } } # Group Pricing Retrieve pricing information. ## Price Categories [/pricing/pricecategories] ### Get Price Categories [GET] Retrieve all price categories. **Required scope:** `Pricing:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PriceCategoriesResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Voksen", "description": "Adult ticket", "displayName": "Voksen", "order": 1, "reducedPrice": false } ] } # Group Partners Manage partners, contacts, business codes, and groups. ## Partners [/partners] ### Create Partner [POST] Create a partner and primary contact. Requires `Partners:Create`. Required string fields are `company`, `email`, `primaryContactFirstName`, `primaryContactLastName`, and `primaryContactEmail`; `businessCodeId` is a required GUID. Optional strings are `cvrNumber`, `note`, `street`, `city`, `zipCode`, `country`, `phone`, and `primaryContactPhone`. `sendCreationEmail` is an optional boolean that defaults to `false`. + Request (application/json) + Attributes (CreatePartnerRequest) + Body { "company": "Example Partner", "cvrNumber": "12345678", "note": "Partner note", "street": "Example Street 1", "city": "Vejle", "zipCode": "7100", "country": "Denmark", "email": "contact@example.com", "phone": "+4512345678", "businessCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "primaryContactFirstName": "Alex", "primaryContactLastName": "Jensen", "primaryContactEmail": "alex@example.com", "primaryContactPhone": "+4587654321", "sendCreationEmail": false } + Response 200 (application/json) + Attributes (PartnerResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "company": "Example Partner", "cvrNumber": "12345678", "note": "Partner note", "email": "contact@example.com", "phone": "+4512345678", "street": "Example Street 1", "city": "Vejle", "zipCode": "7100", "country": "Denmark", "primaryContact": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Alex", "lastName": "Jensen", "partnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partner": "Example Partner", "role": "Administrator", "isPrimary": true, "department": null, "description": null, "office": null, "title": null, "email": "alex@example.com", "phone": "+4587654321" }, "businessCode": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Example business code", "description": null }, "partnerGroups": [], "isLockout": false } } + Response 400 (application/json) { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": [ "Company is required" ] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "Business code not found", "errors": [] } + Response 409 (application/json) { "statusCode": 409, "isSuccess": false, "errorMessage": "A contact with that email already exists", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Partner [/partners/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner ID (GUID) ### Get Partner [GET] Retrieve a partner by ID. A missing partner currently results in a 500 error because the API client returns null and the handler attempts to map it. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "company": "Sponsor A/S", "cvrNumber": "12345678", "note": "", "email": "contact@sponsor.dk", "phone": "+4587654321", "street": "Sponsorgade 10", "city": "Vejle", "zipCode": "7100", "country": "Danmark", "primaryContact": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Lars", "lastName": "Hansen", "partnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partner": "Sponsor A/S", "role": "Administrator", "isPrimary": true, "department": null, "description": null, "office": null, "title": "Sponsorchef", "email": "lars@sponsor.dk", "phone": "+4587654322" }, "businessCode": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Hovedsponsor", "description": null }, "partnerGroups": [ { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VIP Partners", "description": "Partners with VIP access" } ], "isLockout": false } } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ### Update Partner [PUT] Update a partner. Requires `Partners:Update`. The route ID, `company`, `email`, and `businessCodeId` are required. Optional strings are `cvrNumber`, `note`, `street`, `city`, `zipCode`, `country`, and `phone`; `lockout` is an optional timestamp. A successful response has no body. + Request (application/json) + Attributes (UpdatePartnerRequest) + Body { "company": "Example Partner", "cvrNumber": "12345678", "note": "Updated note", "street": "Example Street 1", "city": "Vejle", "zipCode": "7100", "country": "Denmark", "email": "contact@example.com", "phone": "+4512345678", "businessCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "lockout": null } + Response 200 + Response 400 (application/problem+json) + Attributes (ProblemDetails) + Body { "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1", "title": "One or more validation errors occurred.", "status": 400, "instance": "/v1/partners/3fa85f64-5717-4562-b3fc-2c963f66afa6", "traceId": "0HN1234567890:00000001", "errors": [ { "name": "company", "reason": "Company is required" } ] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "Partner not found", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ### Delete Partner [DELETE] Delete a partner. Requires `Partners:Delete`. + Response 204 + Response 400 (application/json) { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": [] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "entity not found", "errors": ["Partner with key 3fa85f64-5717-4562-b3fc-2c963f66afa6 not found"] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Partner Contacts [/partners/{id}/contacts] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner ID (GUID) ### Get Partner Contacts [GET] Retrieve all contacts for a partner. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerContactsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Lars", "lastName": "Hansen", "partnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partner": "Sponsor A/S", "role": "Administrator", "isPrimary": true, "department": null, "description": null, "office": null, "title": "Sponsorchef", "email": "lars@sponsor.dk", "phone": "+4587654322" } ] } ### Create Partner Contact [POST] Add a contact to this partner. Requires `Partners:Create`. `firstName`, `lastName`, and `email` are required strings. Optional strings are `phone`, `department`, `description`, `office`, and `title`. If present, `role` is `Administrator` or `Employee`; it defaults to `Employee`. + Request (application/json) + Attributes (CreatePartnerContactRequest) + Body { "firstName": "Alex", "lastName": "Jensen", "email": "alex@example.com", "phone": "+4512345678", "department": "Sales", "description": "Primary contact", "office": "Vejle", "title": "Manager", "role": "Employee" } + Response 200 (application/json) + Attributes (PartnerContactResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "partnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Alex", "lastName": "Jensen", "partner": "Example Partner", "role": "Employee", "isPrimary": false, "department": "Sales", "description": "Primary contact", "office": "Vejle", "title": "Manager", "email": "alex@example.com", "phone": "+4512345678" } } + Response 400 (application/json) { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": [ "FirstName is required" ] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "Partner not found", "errors": [] } + Response 409 (application/json) { "statusCode": 409, "isSuccess": false, "errorMessage": "A contact with that email already exists", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Partner Contact [/partners/{PartnerId}/contacts/{Id}] + Parameters + PartnerId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner ID (GUID) + Id: `4fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Contact ID (GUID) ### Update Partner Contact [PUT] Update a contact. Requires `Partners:Update`. `firstName`, `lastName`, and `email` are required strings. Optional strings are `phone`, `department`, `description`, `office`, and `title`; `role`, if supplied, is `Administrator` or `Employee`; it defaults to `Employee` when omitted or null. A successful response has no body. + Request (application/json) + Attributes (UpdatePartnerContactRequest) + Body { "firstName": "Alex", "lastName": "Jensen", "email": "alex@example.com", "phone": "+4512345678", "department": "Sales", "description": "Primary contact", "office": "Vejle", "title": "Manager", "role": "Employee" } + Response 200 + Response 400 (application/problem+json) + Attributes (ProblemDetails) + Body { "type": "https://www.rfc-editor.org/rfc/rfc7231#section-6.5.1", "title": "One or more validation errors occurred.", "status": 400, "instance": "/v1/partners/3fa85f64-5717-4562-b3fc-2c963f66afa6/contacts/4fa85f64-5717-4562-b3fc-2c963f66afa6", "traceId": "0HN1234567890:00000002", "errors": [ { "name": "firstName", "reason": "FirstName is required" } ] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "Contact not found", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ### Delete Partner Contact [DELETE] Remove a contact. Requires `Partners:Delete`. Attempting to remove a primary contact returns the same 404 error envelope as a missing contact, with `PartnerContact with key {Id} not found` in `errors`. + Response 204 + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "entity not found", "errors": ["PartnerContact with key 4fa85f64-5717-4562-b3fc-2c963f66afa6 not found"] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Partner Products [/partners/{id}/products] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner ID (GUID) ### Get Partner Products [GET] Retrieve the partner\'s active ticket and registration products. Deleted products are excluded. When both validity bounds are set, the current time in Denmark must fall within them. `timeRestriction` is a duration string such as `02:00:00`, or null. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerAssignedProductsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VIP Lounge", "displayName": "VIP Lounge Package", "productType": "Ticket", "type": "Shared", "orderQuantityRestriction": 10, "productId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "quantity": 50, "remaining": 35, "salesChannelId": 12, "salesChannelName": "Partner Portal", "timeRestriction": null } ] } ## Search Partners [/partners/search{?searchTerm,partnerGroupId,businessCodeId,productId,page,pageSize}] + Parameters + searchTerm: `Sponsor` (string, optional) - Search term to filter partners. Maximum 100 characters. + partnerGroupId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Filter by partner group + businessCodeId: `4fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Filter by business code + productId: `5fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Filter by product + page: `1` (integer, optional) - Page number. Must be greater than 0; defaults to 1. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Search Partners [GET] Search and filter partners with pagination. The response always reports `resultSize` as 0; this value is not a total count. A `pageSize` outside 1 to 100 returns `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnersPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "company": "Sponsor A/S", "cvrNumber": "12345678", "note": "", "email": "contact@sponsor.dk", "phone": "+4587654321", "street": "Sponsorgade 10", "city": "Vejle", "zipCode": "7100", "country": "Danmark", "primaryContact": { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Lars", "lastName": "Hansen", "partnerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partner": "Sponsor A/S", "role": "Administrator", "isPrimary": true, "department": null, "description": null, "office": null, "title": "Sponsorchef", "email": "lars@sponsor.dk", "phone": "+4587654322" }, "businessCode": { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Hovedsponsor", "description": null }, "partnerGroups": [], "isLockout": false } ] } ## Business Codes [/partners/businesscodes{?page,pageSize}] + Parameters + page: `1` (integer, optional) - Requested page number. Defaults to 1. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Get Business Codes [GET] Retrieve a page of business codes. The API skips `page - 1` entries and always returns `page` as 1 and `resultSize` as 0. The `resultSize` value is not a total count. A `pageSize` outside 1 to 100 returns `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (BusinessCodesPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Hovedsponsor", "description": "Primary sponsors" } ] } ## Create Business Code [/partners/businesscodes] ### Create Business Code [POST] Create a new business code. **Required scope:** `Partners:Create` + Request (application/json) + Attributes (CreateBusinessCodeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Hovedsponsor", "description": "Primary sponsors" } + Response 200 (application/json) + Attributes (BusinessCodeResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Hovedsponsor", "description": "Primary sponsors" } } ## Business Code [/partners/businesscodes/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Business Code ID (GUID) ### Update Business Code [PUT] Update an existing business code. **Required scope:** `Partners:Update` + Request (application/json) + Attributes (UpdateBusinessCodeRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Hovedsponsor Updated", "description": "Updated description" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Business code not found"] } ## Partner Groups [/partners/groups] ### Get Partner Groups [GET] Retrieve all partner groups. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerGroupsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VIP Partners", "description": "Partners with VIP access" } ] } ### Create Partner Group [POST] Create a new partner group. **Required scope:** `Partners:Create` + Request (application/json) + Attributes (CreatePartnerGroupRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "VIP Partners", "description": "Partners with VIP access" } + Response 200 (application/json) + Attributes (PartnerGroupResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VIP Partners", "description": "Partners with VIP access" } } ## Partner Group [/partners/groups/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner Group ID (GUID) ### Update Partner Group [PUT] Update an existing partner group. A successful response has no body. **Required scope:** `Partners:Update` + Request (application/json) + Attributes (UpdatePartnerGroupRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "VIP Partners Updated", "description": "Updated description" } + Response 200 ## Partner Group Members [/partners/groups/{id}/members] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Partner Group ID (GUID) ### Get Partner Group Members [GET] Retrieve all members of a partner group. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerGroupMembersResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "company": "Sponsor A/S", "cvrNumber": "12345678", "email": "contact@sponsor.dk", "phone": "+4587654321", "businessCodeId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "businessCodeName": "Hovedsponsor" } ] } ## Add Partner To Group [/partners/groups/add] ### Add Partner To Group [PUT] Add a partner to a partner group. A successful response has no body. **Required scope:** `Partners:Update` + Request (application/json) + Attributes (AddPartnerToGroupRequest) + Headers X-API-KEY: your-api-key-here + Body { "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partnerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6" } + Response 200 ## Remove Partner From Group [/partners/groups/remove] ### Remove Partner From Group [PUT] Remove a partner from a partner group. The handler returns an empty 200 on success. Currently, the global request preprocessor rejects this operation with 400 problem details and the message `Invalid request type` before the handler runs. **Required scope:** `Partners:Update` + Request (application/json) + Attributes (RemovePartnerFromGroupRequest) + Headers X-API-KEY: your-api-key-here + Body { "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partnerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6" } + Response 200 ## Products [/partners/products] ### Get Products [GET] Retrieve all available products for partner assignment. In this response, `productType` describes single or shared use, while `type` identifies the product category. These meanings differ from the assigned products response. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (PartnerProductsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VIP Lounge", "description": "VIP Lounge Package", "productType": "Single", "type": "Ticket" } ] } # Group Webhooks Subscribe to real-time event notifications. When events occur (e.g. tickets created, orders paid), a POST request is sent to your configured URL with the event payload. ## Webhook Collection [/webhooks] ### Get Webhooks [GET] Retrieve all webhook subscriptions for the current API key. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (WebhooksResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Order notifications", "authorizationType": "Basic", "authorizationName": "Authorization", "authorizationValue": "Bearer my-secret-token", "eventName": "OrderCreated", "url": "https://myapp.com/webhooks/orders", "createdBy": "api-key-owner", "createdOnUtc": "2024-01-15T10:00:00Z", "lastModifiedBy": null, "lastModifiedOnUtc": null, "description": null, "tenantId": "06837dd7-13c1-4dc8-94f8-fb555ad8d913" } ] } ### Create Webhook [POST] Create a new webhook subscription. Each API key can only have one subscription per event type. `TicketSubscriptionChanged` is supported for ticket-subscription lifecycle changes: `Activated`, `Renewed`, `PaymentFailed`, `Cancelled`, `Used`, `ReassignedOut`, and `ReassignedIn`. `PaymentFailed` means a renewal payment for an existing subscription was confirmed declined. It is not emitted for pending or timed-out payments, or for an initial payment that never activated a subscription. `Used` describes redemption, not admission. **Supported events:** `TicketCreated`, `TicketActivated`, `TicketUpdated`, `TicketForwarded`, `TicketCancelled`, `TicketReleased`, `SeasonCardCreated`, `SeasonCardActivated`, `SeasonCardUpdated`, `SeasonCardForwarded`, `SeasonCardReleased`, `SeasonCardCancelled`, `OrderCreated`, `OrderPaid`, `OrderCancelled`, `OrderLineCancelled`, `CustomerCreated`, `CustomerUpdated`, `CustomerDeleted`, `ConsentGranted`, `ConsentRetracted`, `PassEntered`, `PartnerRegistration`, `TicketSubscriptionChanged` + Request (application/json) + Attributes (CreateWebhookRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Order notifications", "authorizationType": "Basic", "authorizationName": "Authorization", "authorizationValue": "Bearer my-secret-token", "eventName": "OrderCreated", "uri": "https://myapp.com/webhooks/orders" } + Response 200 (application/json) + Attributes (WebhookResult) { "statusCode": 200, "isSuccess": true, "result": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Order notifications", "authorizationType": "Basic", "authorizationName": "Authorization", "authorizationValue": "Bearer my-secret-token", "eventName": "OrderCreated", "url": "https://myapp.com/webhooks/orders", "createdBy": "api-key-owner", "createdOnUtc": "2024-01-15T10:00:00Z", "lastModifiedBy": null, "lastModifiedOnUtc": null, "description": null, "tenantId": "06837dd7-13c1-4dc8-94f8-fb555ad8d913" } } + Response 409 (application/json) { "statusCode": 409, "isSuccess": false, "errorMessage": "conflict", "errors": ["A webhook for this event already exists for this API key"] } + Response 400 (application/problem+json) + Attributes (ProblemDetails) ## Webhook [/webhooks/{id}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Webhook ID. Must not be the empty GUID. ### Update Webhook [PUT] Update an existing webhook subscription. The request replaces the subscription settings. The subscription ID belongs in the route. Validation failures return `application/problem+json`. + Request (application/json) + Attributes (UpdateWebhookRequest) + Headers X-API-KEY: your-api-key-here + Body { "name": "Order notifications v2", "authorizationType": "Basic", "authorizationName": "Authorization", "authorizationValue": "Bearer my-new-token", "eventName": "OrderCreated", "uri": "https://myapp.com/webhooks/v2/orders" } + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Webhook not found"] } ### Delete Webhook [DELETE] Delete a webhook subscription. + Request + Headers X-API-KEY: your-api-key-here + Response 204 + Response 404 (application/json) { "statusCode": 404, "isSuccess": false, "errorMessage": "not found", "errors": ["Webhook not found"] } ## Webhook Logs [/webhooks/{id}/logs] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Webhook ID. Must not be the empty GUID. ### Get Webhook Logs [GET] Retrieve delivery logs for a webhook subscription. Each log contains the delivered payload as a JSON-encoded string in `dataObject`. The `type` field is currently always null: the upstream DTO supplies `EventName`, but Open.API maps `Type`, leaving the value unset. **Required scope:** `Webhooks:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (WebhookLogsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "subscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "timestamp": "2024-09-15T18:00:05Z", "type": null, "destinationUrl": "https://myapp.com/webhooks/orders", "authorizationType": "Basic", "dataObject": "{\"eventName\":\"OrderCreated\",\"data\":{...}}", "responseCode": "200", "responseContent": "OK" } ] } # Group Webhook Event Payloads Preview the payload structure for each webhook event type. ## Event Payload [/webhooks/event/{EventName}] + Parameters + EventName: `OrderCreated` (string, required) - The event name. Supported: `TicketCreated`, `TicketActivated`, `TicketUpdated`, `TicketForwarded`, `TicketCancelled`, `TicketReleased`, `SeasonCardCreated`, `SeasonCardActivated`, `SeasonCardUpdated`, `SeasonCardForwarded`, `SeasonCardReleased`, `SeasonCardCancelled`, `OrderCreated`, `OrderPaid`, `OrderCancelled`, `OrderLineCancelled`, `CustomerCreated`, `CustomerUpdated`, `CustomerDeleted`, `ConsentGranted`, `ConsentRetracted`, `PassEntered`, `PartnerRegistration`, `TicketSubscriptionChanged` ### Get Event Payload Example [GET] Retrieve a camel-case preview payload for a webhook event type. This preview response is an API-reference example; it is not the JSON contract sent to a subscription URL. `TicketSubscriptionChanged` previews the public ticket-subscription lifecycle shape. Its delivery data excludes upstream marketing fields such as e-mail, related e-mails, holder name, run ID, and contract version. A preview remains a generic `Activated` sample; use the `ChangeKind` value in an actual delivery to handle `PaymentFailed`. Actual webhook delivery is a `POST` to the configured subscription URL. It serializes the envelope and nested event data with PascalCase property names: `EventName`, `IdempotencyKey`, `CreatedAtUtc`, and `Data`. `IdempotencyKey` is a 32-character GUID without hyphens. For the usual integration events, `Data` also contains `Id`, `CreationDate`, `TenantId`, and `OrganiserId`; the envelope `CreatedAtUtc` is that event's `CreationDate`. A `PaymentFailed` delivery has `Data.Status` set to `Expired`; a subsequent `Renewed` delivery can also remain `Expired` while the authoritative subscription is catching up. Concrete delivery example: `{"EventName":"TicketSubscriptionChanged","IdempotencyKey":"c7d7cfc80de04a09bdb630847ce48774","CreatedAtUtc":"2026-09-21T10:00:00Z","Data":{"ChangeKind":"PaymentFailed","Status":"Expired"}}`. TicketCreated uses `EventTime` and includes `HolderEmail`, `HolderPhone`, and `HolderType`. TicketActivated includes those contact and type fields in addition to its `EventTimeUtc`. SeasonCardCreated and SeasonCardActivated include `HolderEmail` and `HolderPhone`. TicketForwarded delivers only `TicketId` and `Recipient`, and TicketReleased delivers only `TicketId`; neither carries the usual integration-event metadata and each envelope timestamp is set when it is published. See the Webhooks guide for a formatted delivery example. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (OrderCreatedPayload) **OrderCreated** - Fired when a new order is created. + Body { "eventName": "OrderCreated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "buyerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "buyerFirstName": "John", "buyerLastName": "Doe", "buyerEmail": "john.doe@example.com", "buyerPhoneNumber": "+4512345678", "buyerCompany": "", "buyerVatNumber": "", "buyerStreet": "Vestergade 1", "buyerCity": "København", "buyerPostalCode": "1456", "buyerCountry": "Danmark", "deliveryMethod": "Digital", "deliveryFee": 0.00, "orderTotal": 150.00, "salesChannel": "Webshop", "orderCreationTime": "2024-09-15T12:00:00Z", "items": [ { "itemId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "productId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "productName": "VFF - OB", "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Voksen", "sectionName": "Section A", "seatNumber": "", "rowNumber": "", "price": 150.00, "fee": 0.00, "itemType": "Ticket", "isSubscription": false, "isDiscount": false } ] } } + Response 200 (application/json) + Attributes (OrderPaidPayload) **OrderPaid** - Fired when an order is paid. + Body { "eventName": "OrderPaid", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:05:00Z", "data": { "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "buyerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "buyerFirstName": "John", "buyerLastName": "Doe", "buyerEmail": "john.doe@example.com", "buyerPhoneNumber": "+4512345678", "buyerCompany": "", "buyerVatNumber": "", "buyerStreet": "Vestergade 1", "buyerCity": "København", "buyerPostalCode": "1456", "buyerCountry": "Danmark", "deliveryMethod": "Digital", "deliveryFee": 0.00, "orderTotal": 150.00, "salesChannel": "Webshop", "orderCreationTime": "2024-09-15T12:00:00Z", "items": [ { "itemId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "productId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "productName": "VFF - OB", "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Voksen", "sectionName": "Section A", "seatNumber": "", "rowNumber": "", "price": 150.00, "fee": 0.00, "itemType": "Ticket", "isSubscription": false, "isDiscount": false } ], "transactionId": "txn_a1b2c3d4e5f6", "transactionTime": "2024-09-15T12:05:00Z", "transactionFee": 5.00 } } + Response 200 (application/json) + Attributes (OrderCancelledPayload) **OrderCancelled** - Fired when an order is cancelled. + Body { "eventName": "OrderCancelled", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:10:00Z", "data": { "orderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "orderNumber": "1725522", "buyerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "buyerFirstName": "John", "buyerLastName": "Doe", "buyerEmail": "john.doe@example.com", "buyerPhoneNumber": "+4512345678", "buyerCompany": "", "buyerVatNumber": "", "buyerStreet": "Vestergade 1", "buyerCity": "København", "buyerPostalCode": "1456", "buyerCountry": "Danmark", "deliveryMethod": "Digital", "deliveryFee": 0.00, "orderTotal": 150.00, "salesChannel": "Webshop", "orderCreationTime": "2024-09-15T12:00:00Z", "items": [ { "itemId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "productId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "productName": "VFF - OB", "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Voksen", "sectionName": "Section A", "seatNumber": "", "rowNumber": "", "price": 150.00, "fee": 0.00, "itemType": "Ticket", "isSubscription": false, "isDiscount": false } ], "cancelledByUsername": "admin@example.com", "cancellationTime": "2024-09-15T12:10:00Z" } } + Response 200 (application/json) + Attributes (TicketCreatedPayload) **TicketCreated** - Fired when a ticket is created. + Body { "eventName": "TicketCreated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "ticketStatus": "Active", "eventId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "OB - VFF", "eventTimeUtc": "2024-09-15T18:00:00Z", "holderId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "holderFirstName": "John", "holderLastName": "Doe", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "sectionId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "seatId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "seatRow": "1", "seatNumber": "1", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Entrance A", "appleWalletUrl": "https://applewallet.com/pass123", "googlePayUrl": "https://googlewallet.com/pass123", "priceCategoryId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Adult" } } + Response 200 (application/json) + Attributes (TicketActivatedPayload) **TicketActivated** - Fired when a ticket is activated. Same payload as TicketCreated. + Body { "eventName": "TicketActivated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "ticketStatus": "Active", "eventId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "OB - VFF", "eventTimeUtc": "2024-09-15T18:00:00Z", "holderId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "holderFirstName": "John", "holderLastName": "Doe", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "sectionId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "seatId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "seatRow": "1", "seatNumber": "1", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Entrance A", "appleWalletUrl": "https://applewallet.com/pass123", "googlePayUrl": "https://googlewallet.com/pass123", "priceCategoryId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Adult" } } + Response 200 (application/json) + Attributes (TicketUpdatedPayload) **TicketUpdated** - Fired when a ticket holder is changed. + Body { "eventName": "TicketUpdated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } } + Response 200 (application/json) + Attributes (TicketCancelledPayload) **TicketCancelled** - Fired when a ticket is cancelled. + Body { "eventName": "TicketCancelled", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } } + Response 200 (application/json) + Attributes (TicketForwardedPayload) **TicketForwarded** - Fired when a ticket is forwarded to another person. + Body { "eventName": "TicketForwarded", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "recipient": "friend@example.com" } } + Response 200 (application/json) + Attributes (SeasonCardCreatedPayload) **SeasonCardCreated** - Fired when a season ticket is created. + Body { "eventName": "SeasonCardCreated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "seasonCardStatus": "Active", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "expirationDateUtc": "2025-06-30T23:59:59Z", "holderId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "holderFirstName": "John", "holderLastName": "Doe", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "sectionId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "seatId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "seatRow": "1", "seatNumber": "1", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Entrance A", "appleWalletUrl": "https://applewallet.com/pass123", "googlePayUrl": "https://googlewallet.com/pass123", "priceCategoryId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Adult" } } + Response 200 (application/json) + Attributes (SeasonCardActivatedPayload) **SeasonCardActivated** - Fired when a season ticket is activated. Same payload as SeasonCardCreated. + Body { "eventName": "SeasonCardActivated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "barcode": "1234567890123456", "seasonCardStatus": "Active", "seasonCardTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "seasonCardTypeName": "Sæsonkort 2024/25", "expirationDateUtc": "2025-06-30T23:59:59Z", "holderId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "holderFirstName": "John", "holderLastName": "Doe", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "sectionId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "sectionName": "Section A", "seatId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "seatRow": "1", "seatNumber": "1", "entranceId": "8fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Entrance A", "appleWalletUrl": "https://applewallet.com/pass123", "googlePayUrl": "https://googlewallet.com/pass123", "priceCategoryId": "9fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Adult" } } + Response 200 (application/json) + Attributes (SeasonCardUpdatedPayload) **SeasonCardUpdated** - Fired when a season ticket holder is changed. + Body { "eventName": "SeasonCardUpdated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } } + Response 200 (application/json) + Attributes (SeasonCardCancelledPayload) **SeasonCardCancelled** - Fired when a season ticket is cancelled. + Body { "eventName": "SeasonCardCancelled", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } } + Response 200 (application/json) + Attributes (SeasonCardForwardedPayload) **SeasonCardForwarded** - Fired when a season ticket is forwarded to another person. + Body { "eventName": "SeasonCardForwarded", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ], "recipient": "friend@example.com" } } + Response 200 (application/json) + Attributes (SeasonCardReleasedPayload) **SeasonCardReleased** - Fired when a season ticket is released for a specific event. + Body { "eventName": "SeasonCardReleased", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "seasonCardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "eventId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "OB - VFF", "holderExternalIds": [ { "provider": "LigaLogin", "providerId": "123456" } ] } } + Response 200 (application/json) + Attributes (TicketReleasedPayload) **TicketReleased** - Fired when a ticket is released. + Body { "eventName": "TicketReleased", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "ticketId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } } + Response 200 (application/json) + Attributes (OrderLineCancelledPayload) **OrderLineCancelled** - Fired when an individual order line is cancelled. + Body { "eventName": "OrderLineCancelled", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:15:00Z", "data": { "orderLineId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } } + Response 200 (application/json) + Attributes (CustomerCreatedPayload) **CustomerCreated** - Fired when a new customer is created. + Body { "eventName": "CustomerCreated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "gender": "Male", "birthDate": "1990-01-01T00:00:00", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "country": "Danmark", "email": "john.doe@example.com", "phone": "+4512345678", "company": "" } } + Response 200 (application/json) + Attributes (CustomerUpdatedPayload) **CustomerUpdated** - Fired when a customer is updated. + Body { "eventName": "CustomerUpdated", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "gender": "Male", "birthDate": "1990-01-01T00:00:00", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "country": "Danmark", "email": "john.doe@example.com", "phone": "+4512345678", "company": "", "loyaltyBalance": 120 } } + Response 200 (application/json) + Attributes (CustomerDeletedPayload) **CustomerDeleted** - Fired when a customer is deleted. + Body { "eventName": "CustomerDeleted", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "gender": "Male", "birthDate": "1990-01-01T00:00:00", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "country": "Danmark", "email": "john.doe@example.com", "phone": "+4512345678", "company": "" } } + Response 200 (application/json) + Attributes (ConsentGrantedPayload) **ConsentGranted** - Fired when a customer grants consent. + Body { "eventName": "ConsentGranted", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phoneNumber": "+4512345678", "consentTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "consentTypeName": "Marketing", "consentTypeKind": "Email" } } + Response 200 (application/json) + Attributes (ConsentRetractedPayload) **ConsentRetracted** - Fired when a customer retracts consent. + Body { "eventName": "ConsentRetracted", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "email": "john.doe@example.com", "phoneNumber": "+4512345678", "consentTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "consentTypeName": "Marketing", "consentTypeKind": "Email" } } + Response 200 (application/json) + Attributes (PartnerRegistrationPayload) **PartnerRegistration** - Fired when a partner registration is created. + Body { "eventName": "PartnerRegistration", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T12:00:00Z", "data": { "registrationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "partnerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "partnerName": "Sponsor A/S", "registrationProductId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "registrationProductName": "VIP Lounge Package", "registrationOptionId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "registrationOptionName": "Table for 10", "eventId": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "VFF - OB", "eventTime": "2024-09-15T18:00:00Z", "participant": "Lars Hansen", "participantEmail": "lars@sponsor.dk", "participantMobile": "+4587654321", "buyerFirstName": "Lars", "buyerLastName": "Hansen", "buyerCompany": "Sponsor A/S", "buyerEmail": "lars@sponsor.dk", "timestamp": "2024-09-15T10:30:00Z", "note": "" } } + Response 200 (application/json) + Attributes (PassEnteredPayload) **PassEntered** - Fired when a pass (ticket or season ticket) is scanned at an entrance. + Body { "eventName": "PassEntered", "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "createdAtUtc": "2024-09-15T17:45:00Z", "data": { "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "type": "SeasonCard", "timestamp": "2024-09-15T17:45:00Z", "entranceId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "entranceName": "Indgang 6", "eventId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "OB - VFF", "holderId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "holderEmail": "john.doe@example.com", "section": "A", "priceCategory": "Standard" } } + Response 200 (application/json) + Attributes (TicketSubscriptionChangedPayload) **TicketSubscriptionChanged** - Fired for an accepted ticket-subscription lifecycle change. + Body { "eventName": "TicketSubscriptionChanged", "idempotencyKey": "b7d7cfc8-0de0-4a09-bdb6-30847ce48773", "createdAtUtc": "2026-09-17T10:00:00Z", "data": { "id": "b7d7cfc8-0de0-4a09-bdb6-30847ce48773", "creationDate": "2026-09-17T10:00:00Z", "tenantId": "06837dd7-13c1-4dc8-94f8-fb555ad8d913", "organiserId": "06837dd7-13c1-4dc8-94f8-fb555ad8d913", "ticketSubscriptionVersion": 42, "changeKind": "Activated", "ticketSubscriptionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "customerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "ownerType": "Customer", "ownerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "cardTypeId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "cardTypeName": "Season ticket", "priceCategoryId": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategoryName": "Adult", "status": "Active", "expirationUtc": "2027-06-01T00:00:00Z", "usedEventId": null, "usedEventName": null, "usedEventStartUtc": null } } + Response 400 (application/json) { "statusCode": 400, "isSuccess": false, "errorMessage": "bad request", "errors": ["'EventName' must be a supported event. See property descriptions for supported events"] } # Group Sync Data synchronization endpoints for exports and incremental customer updates. ## Sync Customers [/sync/customers{?pageSize,page,cursor,createdFrom,createdToExclusive,updatedSince}] + Parameters + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. + page: `1` (integer, optional) - Page number. Defaults to 1. Retained for the first page and compatibility; pages based on page numbers can shift as data changes. + cursor: `illustrativeCursor` (string, optional) - Opaque cursor from the previous response's nextCursor. Recommended for walking all rows. + createdFrom: `2023-01-01T00:00:00Z` (DateTime, optional) - Include records created at or after this time. + createdToExclusive: `2024-01-01T00:00:00Z` (DateTime, optional) - Include records created before this time. + updatedSince: `2024-01-01T00:00:00Z` (DateTime, optional) - Include customers created or changed at or after this time, ordered by last change then id. ### Get Customers [GET] Retrieve a page of customers for synchronization. **Breaking change:** a request without parameters returns the first 50 rows, rather than the whole club. Each export record includes `loyaltyBalance`, consent history, and creation and update metadata. It uses the sync customer model. Pass `nextCursor` from the previous response as `cursor` to get the next page. A cursor walk returns every row that existed and did not change exactly once, even while other rows are added, changed or deleted. The cursor is bound to the filters and club of the request that returned it. A malformed cursor, different filters, a cursor issued for a different club, or a cursor combined with a `page` other than 1 returns `400 Bad Request`. An empty final page has no rows. Times use ISO 8601. A time with an offset is converted to UTC; a time without an offset is read as UTC. Times before the year 2000 return `400 Bad Request`. A `pageSize` outside 1 to 100 returns `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. With `updatedSince`, results are ordered by last change then `id`. With only creation filters, results are ordered by creation time then `id`. Otherwise, results are ordered by `id`. The `updatedSince` filter covers master data, anonymisation and consent changes. It does not cover loyalty point balance changes from loyalty actions or point expiry, external ids or last activity. Deleted customers are not returned. Subscribe to `CustomerDeleted` webhooks to learn about deletions. The response includes `statusCode`, `isSuccess`, `page`, `pageSize`, `resultSize`, `data` and `nextCursor`. The `resultSize` is the number of rows in this page, not a total. The `nextCursor` is null on the last page. First page request: `GET /v1/sync/customers?pageSize=1&updatedSince=2024-01-01T00:00:00Z`. Next page request: `GET /v1/sync/customers?pageSize=1&updatedSince=2024-01-01T00:00:00Z&cursor=exampleCustomerCursor`. The cursor values below are illustrative. Always use the value returned by the API. **Required scope:** `Customers:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SyncCustomersResult) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 1, "resultSize": 1, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Mette", "lastName": "Jensen", "email": "mette.jensen@example.com", "phone": "+4512345678", "birthday": "1990-01-01T00:00:00Z", "street": "Vestergade 1", "city": "København", "zipCode": "1456", "createdAt": "2023-01-15T10:00:00Z", "lastModified": "2024-01-15T10:00:00Z", "lastModifiedBy": "ticketoffice@example.com", "loyaltyBalance": 150, "consents": [ { "consentTypeId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "consentTypeName": "Nyhedsbrev", "grantedTimestamp": "2024-01-15T10:00:00Z", "retractedTimestamp": null, "kind": "Newsletter" } ] } ], "nextCursor": "exampleCustomerCursor" } + Response 200 (application/json) + Attributes (SyncCustomersResult) { "statusCode": 200, "isSuccess": true, "page": 2, "pageSize": 1, "resultSize": 0, "data": [], "nextCursor": null } ## Sync Partners [/sync/partners{?pageSize,page,cursor,createdFrom,createdToExclusive}] + Parameters + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. + page: `1` (integer, optional) - Page number. Defaults to 1. Retained for the first page and compatibility; pages based on page numbers can shift as data changes. + cursor: `illustrativeCursor` (string, optional) - Opaque cursor from the previous response's nextCursor. Recommended for walking all rows. + createdFrom: `2023-01-01T00:00:00Z` (DateTime, optional) - Include records created at or after this time. + createdToExclusive: `2024-01-01T00:00:00Z` (DateTime, optional) - Include records created before this time. ### Get Partners [GET] Retrieve a page of partners for synchronization. **Breaking change:** a request without parameters returns the first 50 rows, rather than the whole club. Each export record contains a business code label, contacts, groups, and separate ticket and registration product lists. It uses the sync partner model. Pass `nextCursor` from the previous response as `cursor` to get the next page. A cursor walk returns every row that existed and did not change exactly once, even while other rows are added, changed or deleted. The cursor is bound to the filters and club of the request that returned it. A malformed cursor, different filters, a cursor issued for a different club, or a cursor combined with a `page` other than 1 returns `400 Bad Request`. An empty final page has no rows. Times use ISO 8601. A time with an offset is converted to UTC; a time without an offset is read as UTC. Times before the year 2000 return `400 Bad Request`. A `pageSize` outside 1 to 100 returns `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. With creation filters, results are ordered by creation time then `id`. Otherwise, results are ordered by `id`. Partners do not support `updatedSince` because changes to contacts, groups, products and ordered tickets do not record a change time. Use `createdFrom` for new partners and a periodic full walk for changes. The response includes `statusCode`, `isSuccess`, `page`, `pageSize`, `resultSize`, `data` and `nextCursor`. The `resultSize` is the number of rows in this page, not a total. The `nextCursor` is null on the last page. First page request: `GET /v1/sync/partners?pageSize=1`. Next page request: `GET /v1/sync/partners?pageSize=1&cursor=examplePartnerCursor`. The cursor values below are illustrative. Always use the value returned by the API. **Required scope:** `Partners:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SyncPartnersResult) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 1, "resultSize": 1, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "company": "Sponsor A/S", "email": "kontakt@example.com", "phone": "+4587654321", "businessCode": "IT", "contacts": [ { "id": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Lars", "lastName": "Nielsen", "email": "lars.nielsen@example.com", "phone": "+4512345678", "isPrimary": true } ], "partnerGroups": [ { "id": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Erhvervspartnere" } ], "ticketProducts": [ { "id": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Partnerbilletter", "type": "Shared", "quantity": 50, "remaining": 32, "validFrom": "2024-07-01T00:00:00Z", "validTo": "2025-06-30T23:59:59Z", "salesChannel": "partner" } ], "registrationProducts": [ { "id": "7fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Netværksmøde", "type": "Single", "quantity": 4, "remaining": null, "validFrom": null, "validTo": null, "salesChannel": "partner" } ] } ], "nextCursor": "examplePartnerCursor" } + Response 200 (application/json) + Attributes (SyncPartnersResult) { "statusCode": 200, "isSuccess": true, "page": 2, "pageSize": 1, "resultSize": 0, "data": [], "nextCursor": null } ## Sync Season Tickets [/sync/seasoncards{?pageSize}] + Parameters + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Get All Season Tickets [GET] Retrieve all season tickets, subscriptions, and season ticket reservations for synchronization. Returns aggregated data including usage statistics. The `pageSize` parameter defaults to 50 and accepts values from 1 to 100. Values above 100 return `400 Bad Request` with the message `Property 'PageSize' must be between 1 and 100`. This operation still returns the whole result; `pageSize` does not limit the returned records. `/sync/seasoncards` returns a whole club in one call; syncing with `changedSince` on `/seasoncards/query` is the recommended way to keep a copy up to date. Each export record uses the sync card model, with holder details, validity, and usage counts. **Required scope:** `SeasonCards:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (SyncSeasonCardsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "holder": "John Doe", "barcode": "1234567890123456", "holderId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "customerType": "B2C", "email": "john.doe@example.com", "cardTypeId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "cardTypeName": "Sæsonkort 2024/25", "priceCategory": "Voksen", "pluNumber": "", "section": "Section A", "rowNumber": "3", "seatNumber": "15", "status": "Active", "created": "2024-07-01T00:00:00Z", "expiration": "2025-06-30T23:59:59Z", "type": "SeasonCard", "scans": 12, "events": 15, "usage": "80%" } ] } ## Campaigns Sync [/sync/campaigns] ### Start Campaigns Sync [POST] Start a Campaigns historical state bootstrap. Requires `Campaigns:Update` and allows 10 requests per 60 seconds. `components` is required and must select one or more of `Profiles`, `Partners`, `SeasonCards`, `Subscriptions`, `TicketSubscriptions`, or `All`; `All` cannot be combined with other selections. The response is a run status object, not the standard envelope. Its lifecycle is `Pending`, `Running`, `Failed`, or `Completed`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Request (application/json) + Attributes (StartCampaignsSyncRequest) + Body { "components": ["Profiles", "SeasonCards"] } + Response 202 (application/json) + Attributes (CampaignSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Pending", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": [ "Profiles", "SeasonCards" ] } + Response 400 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "rejected", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } + Response 401 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } + Response 409 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "running", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } + Response 500 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } ## Campaigns Sync Run [/sync/campaigns/{runId}] + Parameters + runId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Sync run ID (GUID) ### Get Campaigns Sync [GET] Get Campaigns bootstrap status. Requires `Campaigns:Read` and allows 60 requests per 60 seconds. The response is a run status object, not the standard envelope. Its lifecycle is `Pending`, `Running`, `Failed`, or `Completed`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Response 200 (application/json) + Attributes (CampaignSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Running", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "profileCount": 42, "seasonCardCount": 10, "ticketSubscriptionCount": 5, "profileCheckpoint": "profile-42", "seasonCardCheckpoint": "season-card-10", "ticketSubscriptionCheckpoint": "subscription-5", "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": [ "All" ] } + Response 401 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } + Response 404 + Response 500 (application/json) + Attributes (CampaignSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "profileCount": 0, "seasonCardCount": 0, "ticketSubscriptionCount": 0, "profileCheckpoint": null, "seasonCardCheckpoint": null, "ticketSubscriptionCheckpoint": null, "profilesCompleted": false, "seasonCardsCompleted": false, "ticketSubscriptionsCompleted": false, "failure": null, "components": null } ## HeyLoyalty Sync [/sync/heyloyalty] ### Start HeyLoyalty Sync [POST] Queue a HeyLoyalty historical sync. Requires `Campaigns:Update`, allows 10 requests per 60 seconds, and needs an explicit non-empty `components` selection: `Profiles`, `Partners`, `SeasonCards`, `Subscriptions`, `TicketSubscriptions`, or `All`; `All` cannot be combined with other selections. The API-key tenant must have a configured compatible HeyLoyalty main list. The response is a run status object with lifecycle `Pending`, `Running`, `Failed`, or `Queued`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Request (application/json) + Attributes (StartHeyLoyaltySyncRequest) + Body { "components": ["Profiles"] } + Response 202 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Queued", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "queuedCount": 0, "failure": null, "components": [ "Profiles" ] } + Response 400 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "rejected", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 401 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 409 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "running", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 500 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } ## HeyLoyalty Sync Run [/sync/heyloyalty/{runId}] + Parameters + runId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Sync run ID (GUID) ### Get HeyLoyalty Sync [GET] Get HeyLoyalty source-queue status. Requires `Campaigns:Read` and allows 60 requests per 60 seconds. Queued confirms durable source messages, not provider application. The response is a run status object with lifecycle `Pending`, `Running`, `Failed`, or `Queued`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Response 200 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Queued", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "queuedCount": 42, "failure": null, "components": [ "Profiles" ] } + Response 401 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 404 + Response 500 (application/json) + Attributes (HeyLoyaltyHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } ## Klaviyo Sync [/sync/klaviyo] ### Start Klaviyo Sync [POST] Queue an existing-profile-only Klaviyo historical sync. Requires `Campaigns:Update` and allows 10 requests per 60 seconds. `components` accepts `Profiles`, `Partners`, `SeasonCards`, `Subscriptions`, `TicketSubscriptions`, or `All`; `All` cannot be combined with other selections and is the default when omitted. The response is a run status object with lifecycle `Pending`, `Running`, `Failed`, or `Queued`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Request (application/json) + Attributes (StartKlaviyoSyncRequest) + Body { "components": ["All"] } + Response 202 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Queued", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "queuedCount": 0, "failure": null, "components": [ "All" ] } + Response 400 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "rejected", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 401 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 409 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "running", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 500 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } ## Klaviyo Sync Run [/sync/klaviyo/{runId}] + Parameters + runId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (string, required) - Sync run ID (GUID) ### Get Klaviyo Sync [GET] Get Klaviyo source-queue status. Requires `Campaigns:Read` and allows 60 requests per 60 seconds. The response is a run status object with lifecycle `Pending`, `Running`, `Failed`, or `Queued`. Handler-generated JSON errors return the full run object instead of the standard error envelope; unset fields retain their default values. + Response 200 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "Queued", "startedAt": "2026-09-17T10:00:00Z", "completedAt": null, "queuedCount": 42, "failure": null, "components": [ "All" ] } + Response 401 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "request was unauthorized", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } + Response 404 + Response 500 (application/json) + Attributes (KlaviyoHistoricalSyncRun) { "runId": "00000000-0000-0000-0000-000000000000", "status": "failed", "startedAt": "0001-01-01T00:00:00", "completedAt": null, "queuedCount": 0, "failure": null, "components": null } # Group Reports Data reporting endpoints for analytics and external integrations. ## Match Report [/reports/match/{EventId}] + Parameters + EventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. ### Get Match Report [GET] Retrieve comprehensive match/event report data including orders, buyers, entries, and POS information. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (MatchReportResult) { "statusCode": 200, "isSuccess": true, "result": [ { "eventId": 123, "eventUniqueidentifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "VFF - OB", "eventTime": "2024-09-15T18:00:00", "matchId": 12345, "reservationId": 456, "reservationNumber": "1725522", "createTime": "2024-09-01T10:00:00", "createdBy": "ticketoffice@example.com", "reservationLineId": 789, "barcode": "1234567890123456", "salesPrice": 150, "priceCategoryId": 10, "priceCategoryName": "Voksen", "status": "Active", "sectionId": 20, "section": "Nord", "entrance": "Indgang 6", "isNumbered": true, "seatId": 30, "rowNumber": "3", "seatNumber": "15", "buyerId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "buyerType": "B2C", "buyerFirstName": "Mette", "buyerLastName": "Jensen", "buyerAddress": "Vestergade 1", "buyerPostalCode": "1456", "buyerCity": "København", "buyerPhone": "+4512345678", "buyerEmail": "mette.jensen@example.com", "company": null, "cardId": null, "cardTypeId": null, "cardTypeName": "", "consent": null, "grantedTimestamp": null, "releaseTimestamp": null, "voucherGroupId": null, "voucherGroupName": null, "voucherId": null, "voucherCode": null, "voucherDiscount": null, "discountId": null, "discountName": null, "discountAmount": null, "giftCardAmount": null, "giftCardCodes": null, "orderNumber": "1725522", "deliveryMethod": "Email", "reservationLineType": "Ticket", "entered": true, "enteredTimestamp": "2024-09-15T17:45:00", "scannedBy": "Scanner 1", "scannedAt": "Indgang 6", "posTransferTimestampUtc": null, "posTransferType": null, "posId": null, "posPluNumber": null, "posHandOuts": null } ] } ## Junu Attendance [/reports/junu/attendance/{eventId}{?page,pageSize}] + Parameters + eventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. + page: `1` (integer, optional) - Page number. Must be at least 1; defaults to 1. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Get Junu Attendance Data [GET] Retrieve attendance data for Junu integration. A `page` below 1 or a `pageSize` outside 1 to 100 returns `400 Bad Request`. This endpoint always returns `page` as 1 and `resultSize` as 0. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (JunuAttendancePage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "timestamp": "2024-09-15T17:45:00", "eventId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "customerId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "ticketTypeId": "6fa85f64-5717-4562-b3fc-2c963f66afa6" } ] } ## Junu Customers [/reports/junu/customers{?page,pageSize}] + Parameters + page: `1` (integer, optional) - Page number. Must be at least 1; defaults to 1. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Get Junu Customers Data [GET] Retrieve customer data for Junu integration. A `page` below 1 or a `pageSize` outside 1 to 100 returns `400 Bad Request`. This endpoint always returns `page` as 1 and `resultSize` as 0. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (JunuCustomersPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "John", "lastName": "Doe", "fullName": "John Doe", "email": "john.doe@example.com", "birthdate": "1990-01-01T00:00:00", "country": "Danmark", "gender": "1", "zipCode": "1456" } ] } ## Junu Events [/reports/junu/events{?page,pageSize,timestamp}] + Parameters + page: `1` (integer, optional) - Page number. Defaults to 1; must be greater than 0. + pageSize: `50` (integer, optional) - Page size. Defaults to 50; must be between 1 and 100. + timestamp: `2024-01-01T00:00:00Z` (DateTime, optional) - Filter events after this timestamp. Defaults to the start of the current month. ### Get Junu Events Data [GET] Retrieve event data for Junu integration. This endpoint always returns `page` as 1 and `resultSize` as 0. The response `pageSize` is the total number of matching events before pagination. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (JunuEventsPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 1, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "VFF - OB", "date": "2024-09-15T18:00:00", "type": "Superliga", "matchId": 12345 } ] } ## Junu Ticket Types [/reports/junu/tickettypes] ### Get Junu Ticket Types Data [GET] Retrieve ticket type data for Junu integration. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (JunuTicketTypesResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "name": "Voksen" } ] } ## Junu Transactions [/reports/junu/transaction/{eventId}{?page,pageSize}] + Parameters + eventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. + page: `1` (integer, optional) - Page number. Must be at least 1; defaults to 1. + pageSize: `50` (integer, optional) - Page size. Must be between 1 and 100; defaults to 50. ### Get Junu Transaction Data [GET] Retrieve transaction data for Junu integration. A `page` below 1 or a `pageSize` outside 1 to 100 returns `400 Bad Request`. This endpoint always returns `page` as 1 and `resultSize` as 0. + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (JunuTransactionsPage) { "statusCode": 200, "isSuccess": true, "page": 1, "pageSize": 50, "resultSize": 0, "data": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "timestamp": "2024-09-15T12:00:00", "ticketType": "6fa85f64-5717-4562-b3fc-2c963f66afa6", "eventId": "4fa85f64-5717-4562-b3fc-2c963f66afa6", "customerId": "5fa85f64-5717-4562-b3fc-2c963f66afa6", "priceCategory": "Voksen", "price": 15000, "cancelled": false, "currency": "DKK", "tribune": "Nord", "section": "Section A", "entrance": "Indgang 1", "group": "", "rowNumber": "3", "seatNumber": "15", "barcode": "1234567890123456", "salesChannel": "Webshop", "paymentGateway": "Yes", "transactionId": "txn_abc123", "priceCategoryId": "7fa85f64-5717-4562-b3fc-2c963f66afa6" } ] } ## Access Card Report [/reports/access-cards/{EventId}] + Parameters + EventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. ### Get Access Card Counts [GET] Retrieve measured all-access card entries grouped by card type. Requires `Reporting:read`, allows 100 requests per 60 seconds, and caches each API-key response for two minutes. + Response 200 (application/json) + Attributes (AccessCardCountsResult) { "statusCode": 200, "isSuccess": true, "result": [{ "type": "AccessCard", "entryCount": 3, "source": "measured-entry", "cards": [{ "name": "(1234567890) Press Box", "entryCount": 2 }] }] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Attendance Adjustments [/reports/attendance-adjustments/{EventId}] + Parameters + EventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. ### Get Attendance Adjustments [GET] Retrieve manual attendance adjustments. Requires `Reporting:read`, allows 100 requests per 60 seconds, and caches each API-key response for two minutes. Amount can be negative; preserve the manual/measured distinction. + Response 200 (application/json) + Attributes (AttendanceAdjustmentsResult) { "statusCode": 200, "isSuccess": true, "result": [{ "id": 1, "name": "Sponsor guests", "amount": 120, "source": "manual", "adjustedBy": "ticketoffice@club.example", "adjustTime": "2026-09-17T10:00:00" }] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } ## Manual Upload Report [/reports/manual-uploads/{EventId}] + Parameters + EventId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Event ID. Must not be the empty GUID. ### Get Manual Upload Report [GET] Retrieve one row for each manually uploaded barcode, including unscanned rows and the latest row not superseded by a later barcode reset. Requires `Reporting:read`, allows 100 requests per 60 seconds, and caches each API-key response for two minutes. + Response 200 (application/json) + Attributes (ManualUploadReportResult) { "statusCode": 200, "isSuccess": true, "result": [{ "eventId": 1, "eventUniqueidentifier": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "eventName": "Example Event", "eventTime": "2026-09-17T10:00:00", "barcode": "BAR123456789", "sectionId": 10, "section": "East Stand", "uploadedBy": "gate-operator", "uploadTime": "2026-09-17T09:00:00", "entered": true, "enteredTimestamp": "2026-09-17T09:30:00", "scannedBy": "Scanner A", "scannedAt": "Gate A" }] } + Response 401 (application/json) { "statusCode": 401, "isSuccess": false, "errorMessage": "unauthorized", "errors": [] } + Response 500 (application/json) { "statusCode": 500, "isSuccess": false, "errorMessage": "an error occurred during the request", "errors": ["see logs for more information"] } # Group Products Products are additional purchases such as parking, memberships and upgrades, tied to a customer. Each returned row includes ready to use Apple Wallet and Google Pay URLs. Partners can render these directly without knowing the signing scheme. ## Products By Customer [/products/customer/{id}{?organiserId}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Customer ID (GUID) + organiserId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Organiser filter. When supplied only rows for that organiser are returned; otherwise products across all organisers the customer holds are returned. ### Get Products By Customer [GET] Retrieve every addon Product owned by the customer, optionally filtered to a single organiser. **Required scope:** `Products:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (ProductsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "a1901faf-5b8e-49b5-a5ef-f8c9db1f6b04", "organiserId": "62aa5179-9690-481c-a84f-16ffa22ef636", "organiserName": "Example Organiser", "customerId": "478cb0ac-4f11-445f-8374-08db3a7f92d5", "productId": "3779c71b-9e04-4e61-9851-e2d6580c6012", "productName": "Example Product", "barcode": "5933558100874891", "eventId": null, "eventName": "Example Event", "orderNumber": "484666", "validTo": "2026-05-24T10:00:00Z", "orderTime": "2026-04-24T10:00:00Z", "pluNr": "15", "customerName": "Example Customer", "customerEmail": "customer@example.com", "appleWalletUrl": "https://addons.eventii.dk/v1/products/AppleWallet/a1901faf-5b8e-49b5-a5ef-f8c9db1f6b04/{hash}/62aa5179-9690-481c-a84f-16ffa22ef636", "googlePayUrl": "https://addons.eventii.dk/v1/products/GooglePay/a1901faf-5b8e-49b5-a5ef-f8c9db1f6b04/{hash}/62aa5179-9690-481c-a84f-16ffa22ef636" } ] } # Group Ticket Coupons Ticket coupons are partner-issued discount or benefit vouchers bound to a customer. Like products, each returned row includes pre-baked Apple Wallet and Google Pay URLs. ## Ticket Coupons By Customer [/ticketcoupons/customer/{id}{?organiserId}] + Parameters + id: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, required) - Customer ID (GUID) + organiserId: `3fa85f64-5717-4562-b3fc-2c963f66afa6` (Guid, optional) - Organiser filter. When supplied only rows for that organiser are returned. ### Get Ticket Coupons By Customer [GET] Retrieve every ticket coupon owned by the customer, optionally filtered to a single organiser. **Required scope:** `TicketCoupons:Read` + Request + Headers X-API-KEY: your-api-key-here + Response 200 (application/json) + Attributes (TicketCouponsResult) { "statusCode": 200, "isSuccess": true, "result": [ { "id": "b2a02fbf-6c9f-5ac6-b6ff-f9d0ec2f7c05", "organiserId": "62aa5179-9690-481c-a84f-16ffa22ef636", "organiserName": "Example Organiser", "customerId": "ad0ee4b5-42b4-44ab-8a73-08d9f1ebec44", "ticketCouponTypeId": "e1871b89-a8e7-44cd-bd93-4ce4248dc19d", "productName": "Example Coupon", "salesText": "Example Coupon", "barcode": "9138164606420077", "orderNumber": "484522", "quantity": 50, "price": 5, "pluNr": 5, "priceCategory": "Standard", "validFrom": "2026-04-24T10:00:00Z", "validTo": "2026-05-24T10:00:00Z", "customerFullName": "Example Customer", "customerEmail": "customer@example.com", "appleWalletUrl": "https://addons.eventii.dk/v1/ticketcoupons/AppleWallet/b2a02fbf-6c9f-5ac6-b6ff-f9d0ec2f7c05/{hash}/62aa5179-9690-481c-a84f-16ffa22ef636", "googlePayUrl": "https://addons.eventii.dk/v1/ticketcoupons/GooglePay/b2a02fbf-6c9f-5ac6-b6ff-f9d0ec2f7c05/{hash}/62aa5179-9690-481c-a84f-16ffa22ef636" } ] } # Data Structures ## Envelope (object) + statusCode (integer, required) - HTTP status code. + isSuccess (boolean, required) - Whether the request succeeded. ## ErrorResponse (Envelope) + isSuccess (enum[boolean], required) + Members + `false` + errorMessage (string, required) - Summary of the failure; isSuccess is false for this envelope. + errors (array[string], required) - Individual error messages. ## ProblemDetails (object) + type (string, required) - URI identifying the validation problem type. + title (string, required) - Summary of the validation problem. + status (integer, required) - HTTP status code; validation and missing API key failures return 400. + instance (string, required) - Request path that caused the failure. + traceId (string, required) - Request trace identifier. + errors (array[ProblemDetailsError], required) - Validation failures emitted by FastEndpoints. ## ProblemDetailsError (object) + name (string, required) - Error or field name, using the configured JSON naming policy. + reason (string, required) - Explanation of the validation failure. + code (string) - Validator error code, omitted when unavailable. ## PagedEnvelope (Envelope) + page (integer, required) - Current page. + pageSize (integer, required) - Requested page size. + resultSize (integer, required) - Total result count. + data (array[object], required) - Page items; resource-specific envelopes describe the item type. ## Account (object) + id (Guid, required) - Account ID. + username (string, required) - Account username. + entities (array[AccountEntity], required) - Customer and partner entities linked to the account. + loginLink (string, required) - Magic link for signing in to the tenant's webshop. ## AccountEntity (object) + type (string, required) - Entity type, such as Customer or Partner. + value (string, required) - Linked entity ID. ## AccountResult (Envelope) + result (Account, required) - Account details. ## Identity (object) + id (Guid, required) - Account ID. + email (string, required) - Account email address. + normalizedEmail (string, required) - Email address in uppercase. + userName (string, required) - Account username. + normalizedUserName (string, required) - Username in uppercase. + lockoutEnabled (boolean, required) - Whether account lockout is enabled. + lockoutEnd (DateTime, required, nullable) - Time the account lockout ends, if set. ## IdentityResult (Envelope) + result (Identity, required) - Account identity. ## CreateAccountRequest (object) + email (string, required) - Valid email address, also used as the username. + phoneNumber (string, required) - Phone number that parses as a positive 32-bit integer. + password (string, required) - At least 8 characters with a letter, a digit and one of @$!%*#?&; only letters, digits and those special characters are allowed. + passwordConfirmation (string, required) - Must match the password. + firstName (string, required) - Account holder's first name; must not be empty. + lastName (string, required) - Account holder's last name; must not be empty. + birthday (DateTime, nullable) - Account holder's birthday. + gender (enum[string], nullable) - Accepted gender value; currently not applied when creating the customer. + Members + `None` + `Male` + `Female` + `Other` + address (string, nullable) - Street name and house number. + city (string, nullable) - City. + postalCode (string, nullable) - Postal code. + country (string, nullable) - Country. + company (string, nullable) - Company name. + vatNumber (string, nullable) - VAT or CVR number. + externalIds (array[AccountExternalId], nullable) - External identifiers; each item must contain a nonblank provider and provider ID. ## AccountExternalId (object) + provider (string, required) - External provider name; must not be blank. + providerId (string, required) - ID at the external provider; must not be blank. ## ValidateCredentialsRequest (object) + username (string, required) - Account username; must not be empty. + password (string, required) - Account password; must not be empty. ## ChangePasswordRequest (object) + id (Guid, required) - Account ID; must not be the empty GUID. + currentPassword (string, required) - Current password; must not be empty. + newPassword (string, required) - At least 8 characters with a letter, a digit and one of @$!%*#?&; only letters, digits and those special characters are allowed. ## ApiKey (object) + id (Guid, required) - API key ID. + issuedTo (string, required) - Recipient of the API key. + issuedBy (string, required) - Issuer of the API key. + issuedAtUtc (DateTime, required) - Time the key was issued in UTC. + expiresAtUtc (DateTime, required) - Time the key expires in UTC. + scopes (array[ApiKeyScope], required) - Resource scopes and their permissions. + tenantId (Guid, required) - Tenant ID. + tenantName (string, required) - Tenant name. ## ApiKeyScope (object) + scope (string, required) - Resource scope name. + create (boolean, required) - Whether creating resources is allowed. + read (boolean, required) - Whether reading resources is allowed. + update (boolean, required) - Whether updating resources is allowed. + delete (boolean, required) - Whether deleting resources is allowed. ## ApiKeyResult (Envelope) + result (ApiKey, required) - Current API key details. ## Customer (object) + id (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + fullName (string, required) - Full name. + birthday (DateTime, required, nullable) - Birthday, if recorded. + customFieldValue (string, required, nullable) - Custom field value, if recorded. + gender (string, required) - Gender label; current values are Male, Female and Other. + company (string, required, nullable) - Company name. + cvrNumber (string, required, nullable) - CVR number. + street (string, required, nullable) - Street address. + city (string, required, nullable) - City. + zipCode (string, required, nullable) - Postal code. + country (string, required, nullable) - Country. + email (string, required, nullable) - Email address. + phone (string, required, nullable) - Phone number. + subjectId (string, required) - Identity subject ID. + anonymized (DateTime, required, nullable) - Time the customer was anonymized, if applicable. + anonymizedBy (string, required, nullable) - Identity that anonymized the customer, if applicable. + externalIds (array[CustomerExternalId], required) - External identifiers, grouped by provider. + availableLoyaltyPoints (integer, required) - Available loyalty point balance. ## CustomerExternalId (object) + provider (string, required, nullable) - External provider name. + providerId (string, required, nullable) - ID at the external provider. ## CustomerResult (Envelope) + result (Customer, required) - Customer details. ## ConsentType (object) + id (Guid, required) - Consent type ID. + name (string, required) - Internal name. + description (string, required, nullable) - Description of the consent type. + displayName (string, required) - Name shown to customers. + isRequired (boolean, required) - Whether the consent type is required. + termsLink (string, required) - Link to the terms and conditions. ## ConsentTypeResult (Envelope) + result (ConsentType, required) - Created consent type. ## ConsentTypesResult (Envelope) + result (array[ConsentType], required) - Available consent types. ## CreateConsentTypeRequest (object) + name (string, required) - Internal name; must not be empty. + description (string, nullable) - Description of the consent type. + displayName (string, required) - Name shown to customers; must not be empty. + isRequired (boolean) - Whether the consent type is required; defaults to false when omitted. + termsLink (string, required) - Absolute URI for the terms and conditions; must not be empty. ## UpdateConsentTypeRequest (CreateConsentTypeRequest) ## Consent (object) + id (Guid, required) - Consent record ID. + consentTypeId (Guid, required) - Consent type ID. + consentTypeName (string, required) - Internal name of the consent type. + grantedTimestamp (DateTime, required) - Time consent was granted. + grantedBy (string, required) - Identity that granted consent. + revokedTimestamp (DateTime, required, nullable) - Time consent was revoked, if applicable. + revokedBy (string, required, nullable) - Identity that revoked consent, if applicable. ## CustomerConsentsResult (Envelope) + result (array[Consent], required) - Customer consent records. ## EmptyObjectResult (Envelope) + result (object, required) - Empty object returned after updating a consent type. ## ConsentActionResult (Envelope) + result (object, required, nullable) - Always null after granting or revoking consent. ## CustomerConsent (object) + id (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + street (string, required) - Street address. + city (string, required) - City. + zipCode (string, required) - Postal code. + country (string, required) - Country. + email (string, required) - Email address. + phone (string, required) - Phone number. + consentName (string, required) - Name of the granted consent. + grantedBy (string, required) - Identity that granted consent. + grantedTimestamp (DateTime, required) - Time consent was granted. ## CustomersWithConsentResult (Envelope) + result (array[CustomerConsent], required) - Customers who granted the requested consent type. ## LoyaltyAccount (object) + id (Guid, required) - Customer ID. + points (integer, required) - Available loyalty point balance. + actions (array[LoyaltyAction], required) - Loyalty activity. ## LoyaltyAction (object) + event (string, required) - Event associated with the activity. + name (string, required) - Activity name. + barcode (string, required) - Barcode associated with the activity. + timestamp (DateTime, required) - Time of the activity. + expiration (DateTime, required) - Time the points expire. + points (integer, required) - Number of points for the activity. + type (string, required) - Activity type supplied by the loyalty service. ## LoyaltyAccountResult (Envelope) + result (LoyaltyAccount, required) - Loyalty balance and activity. ## Event (object) + id (Guid, required) - Event ID. + name (string, required) - Internal event name. + displayName (string, required) - Event name shown to customers. + matchId (integer, required) - Match ID. + startTime (DateTime, required) - Event start time. + endTime (DateTime, required, nullable) - Event end time, if set. + openTime (DateTime, required, nullable) - Gate opening time, if set. + eventText (string, required) - Event text. + eventTypeId (Guid, required) - Event type ID. + eventTypeName (string, required) - Event type name. + imageUrl (string, required) - Hero image reference; currently returned without a storage URL prefix. + homeTeamLogoUrl (string, required, nullable) - Home team logo reference, if set; currently returned without a storage URL prefix. + awayLogoTeamLogoUrl (string, required, nullable) - Away team logo reference, if set; currently returned without a storage URL prefix. + venueId (Guid, required) - Venue ID. + venueName (string, required) - Venue name. ## EventResult (Envelope) + result (Event, required) - Event details. ## EventsResult (Envelope) + result (array[Event], required) - Future events. ## EventType (object) + id (Guid, required) - Event type ID. + name (string, required) - Event type name. + description (string, required, nullable) - Internal description, if supplied. ## EventTypeResult (Envelope) + result (EventType, required) - Event type details. ## EventTypesResult (Envelope) + result (array[EventType], required) - Available event types. ## CreateEventTypeRequest (object) + name (string, required) - Display name; must not be empty. + description (string, nullable) - Internal description. ## UpdateEventTypeRequest (object) + name (string, required) - Display name; must not be empty. + description (string, nullable) - Internal description; may be omitted or null. ## Person (object) + id (Guid, required) - Customer ID; the empty GUID is returned when person details are unavailable. + externalId (string, required, nullable) - Single external identifier, if populated by the source. + externalIds (array[PersonExternalId], required, nullable) - External identifiers, if populated by the source. + firstName (string, required, nullable) - First name, if available. + lastName (string, required, nullable) - Last name, if available. + company (string, required, nullable) - Company name, if populated by the source. + gender (enum[string], required) - Gender; None is returned when the constructor does not populate it. + Members + `None` + `Male` + `Female` + `Other` + birthDate (DateTime, required, nullable) - Birth date, if available. ## PersonExternalId (object) + provider (string, required) - External provider name. + providerId (string, required) - ID at the external provider. ## Order (object) + id (Guid, required, nullable) - Order ID, if available. + orderNumber (string, required) - Order number. + transactionId (string, required) - Transaction identifier. + faceValue (number, required, nullable) - Face value, if available. + deliveryPrice (number, required, nullable) - Delivery charge, if available. + totalPrice (number, required) - Total price. + priceCategoryId (Guid, required, nullable) - Price category ID, if available. + priceCategory (string, required) - Price category name. ## SeatingInfo (object) + sectionId (Guid, required) - Section ID. + sectionName (string, required) - Section name. + tribune (string, required, nullable) - Stand name, if available. + entranceId (Guid, required, nullable) - Entrance ID, if available. + entranceName (string, required) - Entrance name. + seatId (Guid, required, nullable) - Seat ID for numbered seating. + seatNumber (string, required, nullable) - Seat number, if assigned. + rowNumber (string, required, nullable) - Row number, if assigned. + isNumbered (boolean, required) - Whether the seating is numbered. ## Ticket (object) + id (Guid, required) - Ticket ID. + barcode (string, required) - Barcode used for access control. + status (string, required) - Ticket status supplied by the ticket service, for example Active. + deliveryType (string, required, nullable) - Delivery method supplied by the ticket service, for example Digital. + expirationTime (DateTime, required, nullable) - Expiration time, if set. + buyerInfo (Person, required) - Buyer details. + holderInfo (Person, required) - Holder details; ticket lookup and customer lists currently use the buyer or customer details for both people. + eventInfo (TicketEvent, required) - Event details. + seatingInfo (SeatingInfo, required) - Seating details. + orderInfo (Order, required) - Order details. + events (array[TicketAction], required) - Ticket activity; currently populated for forwarded tickets. + pdfLink (string, required) - Link to the ticket PDF. + appleWalletLink (string, required) - Link to the Apple Wallet pass. + googlePayLink (string, required) - Link to the Google Wallet pass. ## TicketEvent (object) + id (Guid, required) - Event ID. + name (string, required) - Event name. + description (string, required, nullable) - Currently null; the response constructors do not populate this field. + startTime (DateTime, required) - Event start time. + endTime (DateTime, required, nullable) - Event end time, if set. + gatesOpenTime (DateTime, required, nullable) - Gate opening time, if set. + venueId (Guid, required, nullable) - Venue ID, if available. + venueName (string, required) - Venue name. ## TicketAction (object) + type (string, required) - Activity type; currently Sent for a forwarded ticket. + timeStamp (DateTime, required) - Time of the activity. + message (string, required) - Description of the activity. ## TicketResult (Envelope) + result (Ticket, required) - Ticket details. ## TicketsResult (Envelope) + result (array[Ticket], required) - Customer tickets. ## ForwardTicketRequest (object) + email (string, nullable) - Recipient email address; validated as an email when supplied. The validator permits omission and null. ## SeasonCard (object) + id (Guid, required) - Season ticket ID. + barcode (string, required) - Barcode used for access control. + cardHolder (string, required) - Name printed on the season ticket. + seasonCardTypeId (Guid, required) - Season ticket type ID. + seasonCardTypeName (string, required) - Season ticket type name. + status (string, required) - Season ticket status; known values include Active, Inactive, Expired, Cancelled, Blocked and Pending. + deliveryType (enum[string], required) - Delivery method. + Members + `Print` + `Pickup` + `Send` + `None` + `Digital` + validFrom (DateTime, required, nullable) - Start of validity, if set. + expirationTime (DateTime, required, nullable) - Expiration time, if set. + holderBirthday (DateTime, required, nullable) - Birth date recorded on the season ticket. + buyerInfo (Person, required) - Buyer details. + holderInfo (Person, required) - Holder details. + orderInfo (Order, required, nullable) - Order details, if available. + seatingInfo (SeatingInfo, required, nullable) - Seating details, if available. + appleWalletLink (string, required) - Link to the Apple Wallet pass. + googlePayLink (string, required) - Link to the Google Wallet pass. + validEvents (array[SeasonCardEvent], required) - Valid events; direct and query lookups include future events, while customer lists may include past events. + logEvents (array[SeasonCardLogEvent], required) - Release, ticket issuance and forwarding activity. + releaseEvents (array[SeasonCardReleaseEvent], required) - Events for which the seat was released. + cardTickets (array[SeasonCardIssuedTicket], required) - Tickets issued from the season ticket. + isSubscription (boolean, required) - Whether the season ticket belongs to a subscription. + changeToken (string, nullable) - Opaque sync position of 16 hexadecimal characters, populated by `/seasoncards/query`; may be null in other responses. Send the last received value as `changedSince`. + isDeleted (boolean) - Whether the season ticket was deleted. Deleted season tickets are returned only by `/seasoncards/query` with `changedSince`. + previousCardId (Guid, nullable) - Season ticket this one was renewed from, if any. Set by `/seasoncards/query`; null elsewhere. + nextCardId (Guid, nullable) - Season ticket this one was renewed into, if any. Set by `/seasoncards/query`; null elsewhere. + scans (integer, nullable) - Usage events before today where the season ticket or a ticket issued from it was scanned. Set by `/seasoncards/query`; null elsewhere. + events (integer, nullable) - Usage events before today for which the season ticket was valid, meaning its seat was not released or a ticket issued from it is active. Set by `/seasoncards/query`; null elsewhere. ## SeasonCardEvent (object) + id (Guid, required) - Event ID. + name (string, required) - Event name. + startTime (DateTime, required) - Event start time. + releaseStartTime (DateTime, required, nullable) - Start of the seat release window. + releaseEndTime (DateTime, required, nullable) - End of the seat release window. + issueTicketStartTime (DateTime, required, nullable) - Start of the ticket issuance window. + issueTicketEndTime (DateTime, required, nullable) - End of the ticket issuance window. + venueId (Guid, required, nullable) - Venue ID, if available. + venueName (string, required, nullable) - Venue name, if available. + venueStreet (string, required, nullable) - Venue street address. + venueCity (string, required, nullable) - Venue city. + venueZipCode (string, required, nullable) - Venue postal code. + venueCountry (string, required, nullable) - Venue country. + venueLongitude (number, required, nullable) - Venue longitude. + venueLatitude (number, required, nullable) - Venue latitude. ## SeasonCardLogEvent (object) + eventType (enum[string], required) - Activity type. + Members + `Released` + `SentAsTicket` + `Forwarded` + `Renewed` + `Cancelled` + eventId (Guid, required, nullable) - Event ID; null for forwarding activity. + eventName (string, required, nullable) - Event name; null for forwarding activity. + message (string, required) - Description of the activity. ## SeasonCardReleaseEvent (object) + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + eventTime (DateTime, required) - Event start time. + releasedBy (string, required) - Email address or system identifier that released the seat. + timestamp (DateTime, required) - Time the seat was released. ## SeasonCardIssuedTicket (object) + ticketId (Guid, required) - Issued ticket ID. + orderId (Guid, required) - Order ID for the issued ticket. + orderNumber (string, required) - Order number. + issuedTo (string, required) - Recipient email address. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + eventTime (DateTime, required) - Event start time. + timestamp (DateTime, required) - Time the ticket was issued. ## SeasonCardResult (Envelope) + result (SeasonCard, required) - Season ticket details. ## SeasonCardsResult (Envelope) + result (array[SeasonCard], required) - Customer season tickets. ## SeasonCardsPage (PagedEnvelope) + data (array[SeasonCard], required) - Season tickets on the requested page. ## ForwardSeasonCardRequest (object) + email (string, required) - Recipient email address; must not be empty and must be a valid email address. ## ReleaseSeasonCardRequest (object) + eventId (Guid, required) - Event ID; must not be the empty GUID. ## SendSeasonCardAsTicketRequest (object) + eventId (Guid, required) - Event ID; must be supplied and must not be null. + recipient (string, nullable) - Recipient email address; validated as an email when supplied. The validator permits omission and null. ## SeasonCardTicketError (object) + errorMessage (string, required) - Always bad request for these business errors. + errors (array[string], required) - The business-error message for the failed ticket issuance. + targetSite (object, required, nullable) - Null because the exception has never been thrown. + message (string, required) - Exception message containing the internal BadRequestException type name. + data (object, required) - Empty object for these newly constructed exceptions. + innerException (object, required, nullable) - Null; no inner exception is supplied. + helpLink (string, required, nullable) - Null; no help link is set. + source (string, required, nullable) - Null because the exception has never been thrown. + hResult (integer, required) - Exception HRESULT; currently -2146233088. + stackTrace (string, required, nullable) - Null because the exception has never been thrown. ## TicketSubscription (object) + id (Guid, required) - Subscription ID. + status (string, required) - Subscription status supplied by the subscription service, for example Active. + deliveryType (string, required, nullable) - Delivery method, for example Digital. + seasonCardTypeId (Guid, required) - Season ticket type ID. + seasonCardTypeName (string, required) - Season ticket type name. + validFrom (DateTime, required, nullable) - Start of validity, if set. + expirationTime (DateTime, required, nullable) - Expiration time, if set. + birthDate (DateTime, required, nullable) - Birth date recorded on the subscription. + buyerInfo (Person, required) - Buyer details. + holderInfo (Person, required) - Holder details. + orderInfo (Order, required) - Order details. + tickets (array[Ticket], required) - Tickets issued for the subscription. + validEvents (array[TicketSubscriptionEvent], required) - Currently empty; the response constructor does not populate this list. ## TicketSubscriptionEvent (object) + id (Guid, required) - Event ID. + name (string, required) - Event name. + startTime (DateTime, required, nullable) - Event start time. + endTime (DateTime, required, nullable) - Event end time. + gatesOpenTime (DateTime, required, nullable) - Gate opening time. + releaseStartTime (DateTime, required, nullable) - Start of the seat release window. + releaseEndTime (DateTime, required, nullable) - End of the seat release window. + issueTicketStartTime (DateTime, required, nullable) - Start of the ticket issuance window. + issueTicketEndTime (DateTime, required, nullable) - End of the ticket issuance window. + venueId (Guid, required, nullable) - Venue ID. + venueName (string, required) - Venue name. + venueStreet (string, required) - Venue street address. + venueCity (string, required) - Venue city. + venueZipCode (string, required) - Venue postal code. + venueCountry (string, required) - Venue country. + venueLatitude (number, required, nullable) - Venue latitude. + venueLongitude (number, required, nullable) - Venue longitude. ## TicketSubscriptionsResult (Envelope) + result (array[TicketSubscription], required) - Buyer ticket subscriptions. ## SubscriptionBulkPriceChange (object) + oldAmountMinor (integer, nullable) - Amount before the price change, in minor units (øre), DKK. + newAmountMinor (integer, nullable) - Amount after the price change, in minor units (øre), DKK. + effectiveFromLocalDate (string, nullable) - Local date the new price applies from, `yyyy-MM-dd`. + promotedAtUtc (string, nullable) - When the price change was promoted, UTC ISO 8601 ending in `Z`. ## SubscriptionSync (object) + id (Guid, required) - Subscription ID. + kind (string, required) - `seasonCard` or `ticket`. + customerId (Guid, nullable) - Customer ID; null when the subscription has no customer. + cardId (Guid, nullable) - Season ticket the subscription belongs to; null for ticket subscriptions. + cardTypeId (Guid, nullable) - Season ticket type ID. + cardTypeName (string, nullable) - Season ticket type name. + priceCategoryId (Guid, nullable) - Price category ID. + priceCategoryName (string, nullable) - Price category name. + amountMinor (integer, required) - Current amount in minor units (øre), DKK. + status (string, required) - `Active`, `Expired`, `Cancelled`, `Pending`, `Renewal` or `TerminationPending`. + createdLocal (string, required) - Creation time, CTS server local wall time (Europe/Copenhagen), ISO 8601 without offset. + terminationLocal (string, nullable) - Scheduled termination, CTS server local wall time, ISO 8601 without offset. + cancelledLocal (string, nullable) - Recorded cancellation, CTS server local wall time, ISO 8601 without offset. + successfulPaymentCount (integer, required) - Number of successful payments. + latestBulkPriceChange (SubscriptionBulkPriceChange, nullable) - Latest promoted bulk price change, or null. + changeToken (string, required) - Opaque sync position of 16 hexadecimal characters. Send the last received value as `changedSince`. ## SubscriptionsSyncPage (PagedEnvelope) + resultSize (integer, required) - Number of rows on this page. + data (array[SubscriptionSync], required) - Subscriptions on this page, oldest change first. ## SubscriptionPaymentSync (object) + id (Guid, required) - Payment attempt ID. + seasonCardSubscriptionId (Guid, nullable) - Season ticket subscription the payment belongs to. + ticketSubscriptionId (Guid, nullable) - Ticket subscription the payment belongs to. + timestampLocal (string, nullable) - Payment time recorded by CTS, set from the payment provider, CTS server local wall time (Europe/Copenhagen), ISO 8601 without offset; null only for legacy rows without a timestamp. + status (string, required) - `Accepted`, `Declined` or `Pending`. + amountMinor (integer, nullable) - Amount in minor units (øre), DKK; null for payments before 2023-09-19. + transactionId (string, nullable) - Payment provider transaction ID. + changeToken (string, required) - Opaque sync position of 16 hexadecimal characters. Send the last received value as `changedSince`. ## SubscriptionPaymentsSyncPage (PagedEnvelope) + resultSize (integer, required) - Number of rows on this page. + data (array[SubscriptionPaymentSync], required) - Payment attempts on this page, oldest change first. ## PriceCategory (object) + id (Guid, required) - Price category ID. + name (string, required) - Internal name. + description (string, required) - Internal description. + displayName (string, required) - Name shown to customers. + order (integer, required) - Sort order. + reducedPrice (boolean, required) - Whether this is a reduced price category. ## PriceCategoriesResult (Envelope) + result (array[PriceCategory], required) - Available price categories. ## Product (object) + id (Guid, required) - Purchased product ID. + organiserId (Guid, required) - Organiser ID. + organiserName (string, required, nullable) - Organiser name. + customerId (Guid, required) - Customer ID. + productId (Guid, required) - Product definition ID. + productName (string, required, nullable) - Product name. + barcode (string, required, nullable) - Product barcode. + eventId (Guid, required, nullable) - Associated event ID, if any. + eventName (string, required, nullable) - Associated event name, if any. + orderNumber (string, required, nullable) - Order number. + validTo (DateTime, required, nullable) - End of validity, if set. + orderTime (DateTime, required) - Order time. + pluNr (string, required, nullable) - Product lookup number. + customerName (string, required, nullable) - Customer name. + customerEmail (string, required, nullable) - Customer email address. + appleWalletUrl (string, required, nullable) - Link to the Apple Wallet pass. + googlePayUrl (string, required, nullable) - Link to the Google Wallet pass. ## ProductsResult (Envelope) + result (array[Product], required) - Customer addon purchases. ## TicketCoupon (object) + id (Guid, required) - Ticket coupon ID. + organiserId (Guid, required) - Organiser ID. + organiserName (string, required, nullable) - Organiser name. + customerId (Guid, required) - Customer ID. + ticketCouponTypeId (Guid, required) - Ticket coupon type ID. + productName (string, required, nullable) - Coupon product name. + salesText (string, required, nullable) - Sales description. + barcode (string, required, nullable) - Coupon barcode. + orderNumber (string, required, nullable) - Order number. + quantity (integer, required) - Coupon quantity. + price (number, required) - Coupon price. + pluNr (integer, required, nullable) - Product lookup number. + priceCategory (string, required, nullable) - Price category name. + validFrom (DateTime, required) - Start of validity. + validTo (DateTime, required) - End of validity. + customerFullName (string, required, nullable) - Customer full name. + customerEmail (string, required, nullable) - Customer email address. + appleWalletUrl (string, required, nullable) - Link to the Apple Wallet pass. + googlePayUrl (string, required, nullable) - Link to the Google Wallet pass. ## TicketCouponsResult (Envelope) + result (array[TicketCoupon], required) - Customer ticket coupons. ## Partner (object) + id (Guid, required) - Partner ID. + company (string, required) - Company name. + cvrNumber (string, required, nullable) - Danish company registration number. + note (string, required, nullable) - Internal partner note. + email (string, required, nullable) - Company email address. + phone (string, required, nullable) - Company phone number. + street (string, required, nullable) - Street address. + city (string, required, nullable) - City. + zipCode (string, required, nullable) - Postal code. + country (string, required, nullable) - Country. + primaryContact (PartnerContact, required) - Primary contact. + businessCode (BusinessCode, required) - Assigned business code. Its description is null in partner responses. + partnerGroups (array[PartnerGroup], required) - Groups the partner belongs to. + isLockout (boolean, required) - Whether a lockout timestamp is set. ## PartnerContact (object) + id (Guid, required) - Contact ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + partnerId (Guid, required) - Partner ID. + partner (string, required) - Company name. + role (string, required) - Contact role. Known values are Administrator, Employee, and RestrictedUser. + isPrimary (boolean, required) - Whether this is the primary contact. + department (string, required, nullable) - Department. + description (string, required, nullable) - Job description. + office (string, required, nullable) - Office location. + title (string, required, nullable) - Job title. + email (string, required) - Contact email address. + phone (string, required, nullable) - Contact phone number. ## BusinessCode (object) + id (Guid, required) - Business code ID. + name (string, required) - Business code name. + description (string, required, nullable) - Business code description. ## PartnerGroup (object) + id (Guid, required) - Partner group ID. + name (string, required) - Group name. + description (string, required, nullable) - Group description. ## PartnerGroupMember (object) + id (Guid, required) - Partner ID. + company (string, required) - Company name. + cvrNumber (string, required, nullable) - Danish company registration number. + email (string, required, nullable) - Company email address. + phone (string, required, nullable) - Company phone number. + businessCodeId (Guid, required) - Business code ID. + businessCodeName (string, required) - Business code name. ## PartnerAssignedProduct (object) + id (Guid, required) - Product assignment ID. + productId (Guid, required) - Assigned ticket or registration product ID. + name (string, required) - Product name. + displayName (string, required) - Product display name. + quantity (integer, required) - Assigned quantity. + orderQuantityRestriction (integer, required, nullable) - Maximum quantity per order. + salesChannelId (integer, required, nullable) - Numeric sales channel ID. + salesChannelName (string, required, nullable) - Sales channel name. + timeRestriction (string, required, nullable) - TimeSpan duration, for example 02:00:00 for two hours. + productType (string, required) - Product category. Known values are Ticket and Registration. + type (string, required) - Usage model. Known values are Single and Shared. + remaining (integer, required, nullable) - Remaining shared quantity; null for single-event products. ## PartnerProduct (object) + id (Guid, required) - Product ID. + name (string, required) - Product name. + description (string, required, nullable) - Product description. + productType (string, required) - Usage model. Known values are Single and Shared. + type (string, required) - Product category. Known values are Ticket, Card, Registration, and Purchase. ## PartnerResult (Envelope) + result (Partner, required) - Partner details. ## PartnersPage (PagedEnvelope) + data (array[Partner], required) - Partners on this page. ## PartnerContactResult (Envelope) + result (PartnerContact, required) - Created contact. ## PartnerContactsResult (Envelope) + result (array[PartnerContact], required) - Partner contacts. ## BusinessCodeResult (Envelope) + result (BusinessCode, required) - Created business code. ## BusinessCodesPage (PagedEnvelope) + data (array[BusinessCode], required) - Business codes on this page. ## PartnerGroupResult (Envelope) + result (PartnerGroup, required) - Created partner group. ## PartnerGroupsResult (Envelope) + result (array[PartnerGroup], required) - Partner groups. ## PartnerGroupMembersResult (Envelope) + result (array[PartnerGroupMember], required) - Partners in the group. ## PartnerAssignedProductsResult (Envelope) + result (array[PartnerAssignedProduct], required) - Active assigned products. ## PartnerProductsResult (Envelope) + result (array[PartnerProduct], required) - Products available for assignment. ## CreatePartnerRequest (object) + company (string, required) - Company name. Must not be empty or whitespace. + cvrNumber (string, nullable) - Danish company registration number. + note (string, nullable) - Internal partner note. + street (string, nullable) - Street address. + city (string, nullable) - City. + zipCode (string, nullable) - Postal code. + country (string, nullable) - Country. + email (string, required) - Company email address. Must not be empty or whitespace. + phone (string, nullable) - Company phone number. + businessCodeId (Guid, required) - Business code ID. Must not be the empty GUID. + primaryContactFirstName (string, required) - Primary contact first name. Must not be empty or whitespace. + primaryContactLastName (string, required) - Primary contact last name. Must not be empty or whitespace. + primaryContactEmail (string, required) - Primary contact email address. Must not be empty or whitespace. + primaryContactPhone (string, nullable) - Primary contact phone number. + sendCreationEmail (boolean) - Send a welcome email to the primary contact. Defaults to false. ## UpdatePartnerRequest (object) + company (string, required) - Company name. Must not be empty or whitespace. + cvrNumber (string, nullable) - Danish company registration number. + note (string, nullable) - Internal partner note. + street (string, nullable) - Street address. + city (string, nullable) - City. + zipCode (string, nullable) - Postal code. + country (string, nullable) - Country. + email (string, required) - Company email address. Must not be empty or whitespace. + phone (string, nullable) - Company phone number. + businessCodeId (Guid, required) - Business code ID. Must not be the empty GUID. + lockout (DateTime, nullable) - Lockout timestamp; null clears the lockout. ## CreatePartnerContactRequest (object) + firstName (string, required) - First name. Must not be empty or whitespace. + lastName (string, required) - Last name. Must not be empty or whitespace. + email (string, required) - Email address. Must not be empty or whitespace. + phone (string, nullable) - Phone number. + department (string, nullable) - Department. + description (string, nullable) - Job description. + office (string, nullable) - Office location. + title (string, nullable) - Job title. + role (string, nullable) - Administrator or Employee. Defaults to Employee when omitted or null. ## UpdatePartnerContactRequest (object) + firstName (string, required) - First name. Must not be empty or whitespace. + lastName (string, required) - Last name. Must not be empty or whitespace. + email (string, required) - Email address. Must not be empty or whitespace. + phone (string, nullable) - Phone number. + department (string, nullable) - Department. + description (string, nullable) - Job description. + office (string, nullable) - Office location. + title (string, nullable) - Job title. + role (string, nullable) - Administrator or Employee. Defaults to Employee when omitted or null. ## CreateBusinessCodeRequest (object) + name (string, required) - Business code name. Must not be empty or whitespace. + description (string, nullable) - Business code description. ## UpdateBusinessCodeRequest (object) + name (string, required) - Business code name. Must not be empty or whitespace. + description (string, nullable) - Business code description. ## CreatePartnerGroupRequest (object) + name (string, required) - Group name. Must not be empty or whitespace. Maximum 100 characters. + description (string, nullable) - Group description. Maximum 100 characters. ## UpdatePartnerGroupRequest (object) + name (string, required) - Group name. Must not be empty or whitespace. Maximum 100 characters. + description (string, nullable) - Group description. Maximum 100 characters. ## AddPartnerToGroupRequest (object) + groupId (Guid, required) - Group ID. Must not be the empty GUID. + partnerId (Guid, required) - Partner ID. Must not be the empty GUID. ## RemovePartnerFromGroupRequest (object) + groupId (Guid, required) - Group ID. Must not be the empty GUID. + partnerId (Guid, required) - Partner ID. Must not be the empty GUID. ## Webhook (object) + id (Guid, required) - Subscription ID. + name (string, required, nullable) - Subscription label. + description (string, required, nullable) - Subscription description. + authorizationType (enum[string], required) - Receiver authentication method. + Members + `None` + `Header` + `Query` + `Basic` + `Bearer` + authorizationName (string, required, nullable) - Header or query name, or Basic username. + authorizationValue (string, required, nullable) - Receiver credential. + eventName (string, required) - Subscribed event name. + url (string, required) - Delivery URL. + tenantId (Guid, required) - Tenant ID. + createdBy (string, required) - Subscription creator. + createdOnUtc (DateTime, required) - Creation time in UTC. + lastModifiedBy (string, required, nullable) - Last editor. + lastModifiedOnUtc (DateTime, required, nullable) - Last update time in UTC. ## WebhookResult (Envelope) + result (Webhook, required) - Created subscription. ## WebhooksResult (Envelope) + result (array[Webhook], required) - Subscriptions for the API key. ## CreateWebhookRequest (object) + name (string, nullable) - Optional subscription label. + authorizationType (enum[string], required) - Receiver authentication method. None is rejected by the non-empty validator. + Members + `None` + `Header` + `Query` + `Basic` + `Bearer` + authorizationName (string, nullable) - Required and non-empty for Basic, Header, and Query. + authorizationValue (string, nullable) - Required and non-empty for Basic, Bearer, Header, and Query. + eventName (string, required) - Must match one of the supported event names listed above. + uri (string, nullable) - Delivery URI. A non-empty value must be an absolute URI. Include a valid receiver URI when creating a subscription. ## UpdateWebhookRequest (object) + name (string, nullable) - Replacement subscription label. + authorizationType (enum[string], required) - Receiver authentication method. None is rejected by the non-empty validator. + Members + `None` + `Header` + `Query` + `Basic` + `Bearer` + authorizationName (string, nullable) - Required and non-empty for Basic, Header, and Query. + authorizationValue (string, nullable) - Required and non-empty for Basic, Bearer, Header, and Query. + eventName (string, required) - Must match one of the supported event names listed under Create Webhook. + uri (string, nullable) - Replacement delivery URI. A non-empty value must be an absolute URI. Include a valid receiver URI when updating a subscription. ## WebhookLogEvent (object) + subscriptionId (Guid, required) - Subscription ID. + timestamp (DateTime, required) - Delivery log time. + type (string, required, nullable) - Currently always null because the upstream EventName field is not mapped to Type. + destinationUrl (string, required) - Receiver URL. + authorizationType (string, required) - Authentication method recorded by the delivery service. + dataObject (string, required) - Delivered payload encoded as a JSON string. + responseCode (string, required) - Receiver response code. + responseContent (string, required) - Receiver response content. ## WebhookLogsResult (Envelope) + result (array[WebhookLogEvent], required) - Delivery log entries. ## Payload (object) + eventName (string, required) - Preview event type. + idempotencyKey (string, required) - Preview idempotency key as a hyphenated GUID string. + createdAtUtc (DateTime, required) - Time the preview payload was created, in UTC. + data (object, required) - Event-specific preview data. ## OrderCreatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `OrderCreated` + data (OrderCreatedPreviewData, required) - OrderCreated preview data. ## OrderPaidPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `OrderPaid` + data (OrderPaidPreviewData, required) - OrderPaid preview data. ## OrderCancelledPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `OrderCancelled` + data (OrderCancelledPreviewData, required) - OrderCancelled preview data. ## TicketCreatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketCreated` + data (TicketCreatedPreviewData, required) - TicketCreated preview data. ## TicketActivatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketActivated` + data (TicketActivatedPreviewData, required) - TicketActivated preview data. ## TicketUpdatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketUpdated` + data (TicketUpdatedPreviewData, required) - TicketUpdated preview data. ## TicketCancelledPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketCancelled` + data (TicketCancelledPreviewData, required) - TicketCancelled preview data. ## TicketForwardedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketForwarded` + data (TicketForwardedPreviewData, required) - TicketForwarded preview data. ## SeasonCardCreatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardCreated` + data (SeasonCardCreatedPreviewData, required) - SeasonCardCreated preview data. ## SeasonCardActivatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardActivated` + data (SeasonCardActivatedPreviewData, required) - SeasonCardActivated preview data. ## SeasonCardUpdatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardUpdated` + data (SeasonCardUpdatedPreviewData, required) - SeasonCardUpdated preview data. ## SeasonCardCancelledPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardCancelled` + data (SeasonCardCancelledPreviewData, required) - SeasonCardCancelled preview data. ## SeasonCardForwardedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardForwarded` + data (SeasonCardForwardedPreviewData, required) - SeasonCardForwarded preview data. ## SeasonCardReleasedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `SeasonCardReleased` + data (SeasonCardReleasedPreviewData, required) - SeasonCardReleased preview data. ## TicketReleasedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketReleased` + data (TicketReleasedPreviewData, required) - TicketReleased preview data. ## OrderLineCancelledPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `OrderLineCancelled` + data (OrderLineCancelledPreviewData, required) - OrderLineCancelled preview data. ## CustomerCreatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `CustomerCreated` + data (CustomerCreatedPreviewData, required) - CustomerCreated preview data. ## CustomerUpdatedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `CustomerUpdated` + data (CustomerUpdatedPreviewData, required) - CustomerUpdated preview data. ## CustomerDeletedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `CustomerDeleted` + data (CustomerDeletedPreviewData, required) - CustomerDeleted preview data. ## ConsentGrantedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `ConsentGranted` + data (ConsentGrantedPreviewData, required) - ConsentGranted preview data. ## ConsentRetractedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `ConsentRetracted` + data (ConsentRetractedPreviewData, required) - ConsentRetracted preview data. ## PartnerRegistrationPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `PartnerRegistration` + data (PartnerRegistrationPreviewData, required) - PartnerRegistration preview data. ## PassEnteredPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `PassEntered` + data (PassEnteredPreviewData, required) - PassEntered preview data. ## TicketSubscriptionChangedPayload (Payload) + eventName (enum[string], required) - Preview event type. + Members + `TicketSubscriptionChanged` + data (TicketSubscriptionChangedPreviewData, required) - TicketSubscriptionChanged preview data. ## OrderCreatedPreviewData (object) + orderId (Guid, required) - Order ID. + orderNumber (string, required) - Order number. + buyerId (Guid, required, nullable) - Buyer ID. + buyerFirstName (string, required) - Buyer first name. + buyerLastName (string, required) - Buyer last name. + buyerEmail (string, required) - Buyer email. + buyerPhoneNumber (string, required) - Buyer phone number. + buyerCompany (string, required) - Buyer company. + buyerVatNumber (string, required) - Buyer VAT number. + buyerStreet (string, required) - Buyer street. + buyerCity (string, required) - Buyer city. + buyerPostalCode (string, required) - Buyer postal code. + buyerCountry (string, required) - Buyer country. + deliveryMethod (string, required) - Delivery method. + deliveryFee (number, required) - Delivery fee. + orderTotal (number, required) - Order total. + salesChannel (string, required) - Sales channel. + orderCreationTime (DateTime, required) - Order creation time. + items (array[OrderCreatedItemPreviewData], required) - Items. ## OrderPaidPreviewData (object) + orderId (Guid, required) - Order ID. + orderNumber (string, required) - Order number. + buyerId (Guid, required, nullable) - Buyer ID. + buyerFirstName (string, required) - Buyer first name. + buyerLastName (string, required) - Buyer last name. + buyerEmail (string, required) - Buyer email. + buyerPhoneNumber (string, required) - Buyer phone number. + buyerCompany (string, required) - Buyer company. + buyerVatNumber (string, required) - Buyer VAT number. + buyerStreet (string, required) - Buyer street. + buyerCity (string, required) - Buyer city. + buyerPostalCode (string, required) - Buyer postal code. + buyerCountry (string, required) - Buyer country. + deliveryMethod (string, required) - Delivery method. + deliveryFee (number, required) - Delivery fee. + orderTotal (number, required) - Order total. + salesChannel (string, required) - Sales channel. + orderCreationTime (DateTime, required) - Order creation time. + items (array[OrderPaidItemPreviewData], required) - Items. + transactionId (string, required) - Transaction ID. + transactionTime (DateTime, required) - Transaction time. + transactionFee (number, required) - Transaction fee. ## OrderCancelledPreviewData (object) + orderId (Guid, required) - Order ID. + orderNumber (string, required) - Order number. + buyerId (Guid, required, nullable) - Buyer ID. + buyerFirstName (string, required) - Buyer first name. + buyerLastName (string, required) - Buyer last name. + buyerEmail (string, required) - Buyer email. + buyerPhoneNumber (string, required) - Buyer phone number. + buyerCompany (string, required) - Buyer company. + buyerVatNumber (string, required) - Buyer VAT number. + buyerStreet (string, required) - Buyer street. + buyerCity (string, required) - Buyer city. + buyerPostalCode (string, required) - Buyer postal code. + buyerCountry (string, required) - Buyer country. + deliveryMethod (string, required) - Delivery method. + deliveryFee (number, required) - Delivery fee. + orderTotal (number, required) - Order total. + salesChannel (string, required) - Sales channel. + orderCreationTime (DateTime, required) - Order creation time. + items (array[OrderCancelledItemPreviewData], required) - Items. + cancelledByUsername (string, required) - Cancelled by username. + cancellationTime (DateTime, required, nullable) - Cancellation time. ## TicketCreatedPreviewData (object) + ticketId (Guid, required) - Ticket ID. + barcode (string, required) - Barcode. + ticketStatus (string, required) - Ticket status label; the preview uses Active. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + eventTimeUtc (DateTime, required) - Event time UTC. + holderId (Guid, required, nullable) - Holder ID. + holderFirstName (string, required, nullable) - Holder first name. + holderLastName (string, required, nullable) - Holder last name. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. + sectionId (Guid, required) - Section ID. + sectionName (string, required) - Section name. + seatId (Guid, required, nullable) - Seat ID. + seatRow (string, required, nullable) - Seat row. + seatNumber (string, required, nullable) - Seat number. + entranceId (Guid, required, nullable) - Entrance ID. + entranceName (string, required, nullable) - Entrance name. + appleWalletUrl (string, required) - Apple wallet url. + googlePayUrl (string, required) - Google pay url. + priceCategoryId (Guid, required) - Price category ID. + priceCategoryName (string, required) - Price category name. ## TicketActivatedPreviewData (object) + ticketId (Guid, required) - Ticket ID. + barcode (string, required) - Barcode. + ticketStatus (string, required) - Ticket status label; the preview uses Active. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + eventTimeUtc (DateTime, required) - Event time UTC. + holderId (Guid, required, nullable) - Holder ID. + holderFirstName (string, required, nullable) - Holder first name. + holderLastName (string, required, nullable) - Holder last name. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. + sectionId (Guid, required) - Section ID. + sectionName (string, required) - Section name. + seatId (Guid, required, nullable) - Seat ID. + seatRow (string, required, nullable) - Seat row. + seatNumber (string, required, nullable) - Seat number. + entranceId (Guid, required, nullable) - Entrance ID. + entranceName (string, required, nullable) - Entrance name. + appleWalletUrl (string, required) - Apple wallet url. + googlePayUrl (string, required) - Google pay url. + priceCategoryId (Guid, required) - Price category ID. + priceCategoryName (string, required) - Price category name. ## TicketUpdatedPreviewData (object) + ticketId (Guid, required) - Ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. ## TicketCancelledPreviewData (object) + ticketId (Guid, required) - Ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. ## TicketForwardedPreviewData (object) + ticketId (Guid, required) - Ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. + recipient (string, required) - Recipient. ## SeasonCardCreatedPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + barcode (string, required) - Barcode. + seasonCardStatus (string, required) - Season ticket status label. Known values include Active, Inactive, Blocked, Cancelled, and Pending. + seasonCardTypeId (Guid, required) - Season ticket type ID. + seasonCardTypeName (string, required) - Season ticket type name. + expirationDateUtc (DateTime, required) - Expiration date UTC. + holderId (Guid, required, nullable) - Holder ID. + holderFirstName (string, required, nullable) - Holder first name. + holderLastName (string, required, nullable) - Holder last name. + holderExternalIds (array[ExternalHolderIdPreviewData], required, nullable) - Holder external IDs. + sectionId (Guid, required) - Section ID. + sectionName (string, required) - Section name. + seatId (Guid, required, nullable) - Seat ID. + seatRow (string, required) - Seat row. + seatNumber (string, required) - Seat number. + entranceId (Guid, required, nullable) - Entrance ID. + entranceName (string, required) - Entrance name. + appleWalletUrl (string, required) - Apple wallet url. + googlePayUrl (string, required) - Google pay url. + priceCategoryId (Guid, required) - Price category ID. + priceCategoryName (string, required) - Price category name. ## SeasonCardActivatedPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + barcode (string, required) - Barcode. + seasonCardStatus (string, required) - Season ticket status label. Known values include Active, Inactive, Blocked, Cancelled, and Pending. + seasonCardTypeId (Guid, required) - Season ticket type ID. + seasonCardTypeName (string, required) - Season ticket type name. + expirationDateUtc (DateTime, required) - Expiration date UTC. + holderId (Guid, required, nullable) - Holder ID. + holderFirstName (string, required, nullable) - Holder first name. + holderLastName (string, required, nullable) - Holder last name. + holderExternalIds (array[ExternalHolderIdPreviewData], required, nullable) - Holder external IDs. + sectionId (Guid, required) - Section ID. + sectionName (string, required) - Section name. + seatId (Guid, required, nullable) - Seat ID. + seatRow (string, required) - Seat row. + seatNumber (string, required) - Seat number. + entranceId (Guid, required, nullable) - Entrance ID. + entranceName (string, required) - Entrance name. + appleWalletUrl (string, required) - Apple wallet url. + googlePayUrl (string, required) - Google pay url. + priceCategoryId (Guid, required) - Price category ID. + priceCategoryName (string, required) - Price category name. ## SeasonCardUpdatedPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. ## SeasonCardCancelledPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. ## SeasonCardForwardedPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + holderId (Guid, required, nullable) - Holder ID. + holderExternalIds (array[ExternalHolderIdPreviewData], required) - Holder external IDs. + recipient (string, required) - Recipient. ## SeasonCardReleasedPreviewData (object) + seasonCardId (Guid, required) - Season ticket ID. + holderId (Guid, required, nullable) - Holder ID. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + holderExternalIds (array[ExternalHolderIdPreviewData], required, nullable) - Holder external IDs. ## TicketReleasedPreviewData (object) + ticketId (Guid, required) - Ticket ID. ## OrderLineCancelledPreviewData (object) + orderLineId (Guid, required) - Order line ID. ## CustomerCreatedPreviewData (object) + customerId (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + fullName (string, required) - Full name. + gender (string, required) - Gender label; the preview uses Male. + birthDate (string, required, nullable) - Birth date timestamp with no offset. + street (string, required) - Street. + city (string, required) - City. + zipCode (string, required) - Zip code. + country (string, required) - Country. + email (string, required) - Email. + phone (string, required) - Phone. + company (string, required) - Company. ## CustomerUpdatedPreviewData (object) + customerId (Guid, required) - Customer ID. + firstName (string, required, nullable) - First name. + lastName (string, required, nullable) - Last name. + fullName (string, required, nullable) - Full name. + gender (string, required, nullable) - Gender label; the preview uses Male. + birthDate (string, required, nullable) - Birth date timestamp with no offset. + street (string, required, nullable) - Street. + city (string, required, nullable) - City. + zipCode (string, required, nullable) - Zip code. + country (string, required, nullable) - Country. + email (string, required) - Email. + phone (string, required, nullable) - Phone. + company (string, required, nullable) - Company. + loyaltyBalance (integer, required, nullable) - Loyalty balance. ## CustomerDeletedPreviewData (object) + customerId (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + fullName (string, required) - Full name. + gender (string, required) - Gender label; the preview uses Male. + birthDate (string, required, nullable) - Birth date timestamp with no offset. + street (string, required) - Street. + city (string, required) - City. + zipCode (string, required) - Zip code. + country (string, required) - Country. + email (string, required) - Email. + phone (string, required) - Phone. + company (string, required) - Company. ## ConsentGrantedPreviewData (object) + customerId (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + email (string, required) - Email. + phoneNumber (string, required) - Phone number. + consentTypeId (Guid, required) - Consent type ID. + consentTypeName (string, required) - Consent type name. + consentTypeKind (string, required) - Consent type kind. ## ConsentRetractedPreviewData (object) + customerId (Guid, required) - Customer ID. + firstName (string, required) - First name. + lastName (string, required) - Last name. + email (string, required) - Email. + phoneNumber (string, required) - Phone number. + consentTypeId (Guid, required) - Consent type ID. + consentTypeName (string, required) - Consent type name. + consentTypeKind (string, required) - Consent type kind. ## PartnerRegistrationPreviewData (object) + registrationId (Guid, required) - Registration ID. + partnerId (Guid, required) - Partner ID. + partnerName (string, required) - Partner name. + registrationProductId (Guid, required) - Registration product ID. + registrationProductName (string, required) - Registration product name. + registrationOptionId (Guid, required) - Registration option ID. + registrationOptionName (string, required) - Registration option name. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + eventTime (DateTime, required) - Event time. + participant (string, required) - Participant. + participantEmail (string, required) - Participant email. + participantMobile (string, required, nullable) - Participant mobile. + buyerFirstName (string, required) - Buyer first name. + buyerLastName (string, required) - Buyer last name. + buyerCompany (string, required) - Buyer company. + buyerEmail (string, required) - Buyer email. + timestamp (DateTime, required) - Timestamp. + note (string, required, nullable) - Note. ## PassEnteredPreviewData (object) + entityId (Guid, required) - Entity ID. + type (string, required) - Type. + timestamp (DateTime, required) - Timestamp. + entranceId (Guid, required) - Entrance ID. + entranceName (string, required) - Entrance name. + eventId (Guid, required) - Event ID. + eventName (string, required) - Event name. + holderId (Guid, required, nullable) - Holder ID. + holderEmail (string, required, nullable) - Holder email. + section (string, required) - Section. + priceCategory (string, required) - Price category. ## TicketSubscriptionChangedPreviewData (object) + id (Guid, required) - ID. + creationDate (DateTime, required) - Preview event creation time in UTC. + tenantId (Guid, required) - Tenant ID. + organiserId (Guid, required) - Organiser ID. + ticketSubscriptionVersion (integer, required) - Ticket subscription version. + changeKind (string, required) - Lifecycle change kind; the preview uses Activated. + ticketSubscriptionId (Guid, required) - Ticket subscription ID. + customerId (Guid, required, nullable) - Customer ID. + ownerType (string, required, nullable) - Owner type. + ownerId (Guid, required, nullable) - Owner ID. + cardTypeId (Guid, required) - Card type ID. + cardTypeName (string, required) - Card type name. + priceCategoryId (Guid, required) - Price category ID. + priceCategoryName (string, required) - Price category name. + status (string, required) - Subscription status label; the preview uses Active. + expirationUtc (DateTime, required) - Expiration UTC. + usedEventId (Guid, required, nullable) - Used event ID. + usedEventName (string, required, nullable) - Used event name. + usedEventStartUtc (DateTime, required, nullable) - Start time of the used event in UTC, if available. ## ExternalHolderIdPreviewData (object) + provider (string, required) - Provider. + providerId (string, required) - Provider ID. ## OrderCreatedItemPreviewData (object) + itemId (Guid, required) - Item ID. + productId (Guid, required, nullable) - Product ID. + productName (string, required) - Product name. + priceCategoryId (Guid, required, nullable) - Price category ID. + priceCategoryName (string, required) - Price category name. + sectionName (string, required) - Section name. + seatNumber (string, required) - Seat number. + rowNumber (string, required) - Row number. + price (number, required) - Price. + fee (number, required) - Fee. + itemType (string, required) - Item type. + isSubscription (boolean, required) - Is subscription. + isDiscount (boolean, required) - Is discount. ## OrderPaidItemPreviewData (object) + itemId (Guid, required) - Item ID. + productId (Guid, required, nullable) - Product ID. + productName (string, required) - Product name. + priceCategoryId (Guid, required, nullable) - Price category ID. + priceCategoryName (string, required) - Price category name. + sectionName (string, required) - Section name. + seatNumber (string, required) - Seat number. + rowNumber (string, required) - Row number. + price (number, required) - Price. + fee (number, required) - Fee. + itemType (string, required) - Item type. + isSubscription (boolean, required) - Is subscription. + isDiscount (boolean, required) - Is discount. ## OrderCancelledItemPreviewData (object) + itemId (Guid, required) - Item ID. + productId (Guid, required, nullable) - Product ID. + productName (string, required) - Product name. + priceCategoryId (Guid, required, nullable) - Price category ID. + priceCategoryName (string, required) - Price category name. + sectionName (string, required) - Section name. + seatNumber (string, required) - Seat number. + rowNumber (string, required) - Row number. + price (number, required) - Price. + fee (number, required) - Fee. + itemType (string, required) - Item type. + isSubscription (boolean, required) - Is subscription. + isDiscount (boolean, required) - Is discount. ## SyncCustomer (object) + id (Guid, required) - Customer ID. + firstName (string, required, nullable) - First name. + lastName (string, required, nullable) - Last name. + email (string, required, nullable) - Email address. + phone (string, required, nullable) - Phone number. + birthday (DateTime, required, nullable) - Date of birth as a timestamp. + street (string, required, nullable) - Street address. + city (string, required, nullable) - City. + zipCode (string, required, nullable) - Postal code. + createdAt (DateTime, required) - Creation time. + lastModified (DateTime, required, nullable) - Last update time. + lastModifiedBy (string, required, nullable) - Last editor. + loyaltyBalance (integer, required) - Current loyalty balance. + consents (array[SyncConsent], required) - Customer consents. ## SyncConsent (object) + consentTypeId (Guid, required) - Consent type ID. + consentTypeName (string, required) - Consent type name. + grantedTimestamp (DateTime, required) - Time consent was granted. + retractedTimestamp (DateTime, required, nullable) - Time consent was retracted. + kind (string, required) - Consent kind. Known values are Account, Order, General, and Newsletter. ## SyncCustomersResult (Envelope) + page (integer, required) - Current page. + pageSize (integer, required) - Requested page size. + resultSize (integer, required) - Number of rows in this page. + data (array[SyncCustomer], required) - Customer export with loyalty balances and consents. + nextCursor (string, required, nullable) - Opaque cursor for the next page; null on the last page. ## SyncPartner (object) + id (Guid, required) - Partner ID. + company (string, required) - Company name. + email (string, required, nullable) - Company email address. + phone (string, required, nullable) - Company phone number. + businessCode (string, required, nullable) - Business code label. + contacts (array[SyncPartnerContact], required) - Partner contacts. + partnerGroups (array[SyncPartnerGroup], required) - Assigned groups. + ticketProducts (array[SyncPartnerProduct], required) - Assigned ticket products. + registrationProducts (array[SyncPartnerProduct], required) - Assigned registration products. ## SyncPartnerContact (object) + id (Guid, required) - Contact ID. + firstName (string, required, nullable) - First name. + lastName (string, required, nullable) - Last name. + email (string, required, nullable) - Email address. + phone (string, required, nullable) - Phone number. + isPrimary (boolean, required) - Whether this is the primary contact. ## SyncPartnerGroup (object) + id (Guid, required) - Group ID. + name (string, required) - Group name. ## SyncPartnerProduct (object) + id (Guid, required) - Product ID. + name (string, required) - Product name. + type (string, required) - Single allows the quantity per event; Shared shares it across events. + quantity (integer, required) - Assigned quantity. + remaining (integer, required, nullable) - Remaining quantity for Shared products; null for Single products. + validFrom (DateTime, required, nullable) - Start of the validity period. + validTo (DateTime, required, nullable) - End of the validity period. + salesChannel (string, required, nullable) - Product sales channel. ## SyncPartnersResult (Envelope) + page (integer, required) - Current page. + pageSize (integer, required) - Requested page size. + resultSize (integer, required) - Number of rows in this page. + data (array[SyncPartner], required) - Partner export with contacts, groups, and products. + nextCursor (string, required, nullable) - Opaque cursor for the next page; null on the last page. ## SyncSeasonCard (object) + id (Guid, required) - Card or subscription ID. + holder (string, required, nullable) - Holder name. + barcode (string, required, nullable) - Card barcode. + holderId (Guid, required) - Holder ID. + customerType (string, required) - B2B for partners or B2C for customers. + email (string, required, nullable) - Holder email address. + cardTypeId (Guid, required) - Card type ID. + cardTypeName (string, required) - Card type name. + priceCategory (string, required) - Price category name. + pluNumber (string, required, nullable) - PLU number. + section (string, required, nullable) - Section name. + rowNumber (string, required, nullable) - Seat row; null for unnumbered sections. + seatNumber (string, required, nullable) - Seat number; null for unnumbered sections. + status (string, required) - Current card status. + created (DateTime, required, nullable) - Creation time. + expiration (DateTime, required, nullable) - Expiration time. + type (string, required) - CardReservation, SeasonCard, Subscription, or TicketSubscription. + scans (integer, required) - Scans at events with usage enabled. + events (integer, required) - Eligible events with usage enabled. + usage (string, required, nullable) - Formatted usage percentage. ## SyncSeasonCardsResult (Envelope) + result (array[SyncSeasonCard], required) - Card and subscription export. ## MatchReportDataRecord (object) + eventId (integer, required) - Numeric event ID. + eventUniqueidentifier (Guid, required) - Public event ID. + eventName (string, required) - Event name. + eventTime (string, required) - Event start timestamp with no offset. + matchId (integer, required) - Match ID. + reservationId (integer, required) - Reservation ID. + reservationNumber (string, required) - Reservation number. + createTime (string, required) - Reservation creation timestamp with no offset. + createdBy (string, required) - Reservation creator. + reservationLineId (integer, required) - Reservation line ID. + barcode (string, required) - Admission barcode. + salesPrice (number, required) - Sales price in major currency units. + priceCategoryId (integer, required) - Numeric price category ID. + priceCategoryName (string, required) - Price category name. + status (string, required) - Active or Cancelled. + sectionId (integer, required) - Numeric section ID. + section (string, required) - Section name. + entrance (string, required, nullable) - Assigned entrance. + isNumbered (boolean, required) - Whether seating is numbered. + seatId (integer, required, nullable) - Numeric seat ID. + rowNumber (string, required, nullable) - Seat row. + seatNumber (string, required, nullable) - Seat number. + buyerId (Guid, required, nullable) - Buyer ID. + buyerType (string, required) - B2C, B2B, or Other. + buyerFirstName (string, required, nullable) - Buyer first name. + buyerLastName (string, required, nullable) - Buyer last name. + buyerAddress (string, required, nullable) - Buyer street address. + buyerPostalCode (string, required, nullable) - Buyer postal code. + buyerCity (string, required, nullable) - Buyer city. + buyerPhone (string, required, nullable) - Buyer phone number. + buyerEmail (string, required, nullable) - Buyer email address. + company (string, required, nullable) - Buyer company. + cardId (integer, required, nullable) - Numeric card ID. + cardTypeId (integer, required, nullable) - Numeric card type ID. + cardTypeName (string, required, nullable) - Card type name. + consent (string, required, nullable) - Combined active consent names. + grantedTimestamp (string, required, nullable) - Latest consent grant timestamp with no offset. + releaseTimestamp (string, required, nullable) - Ticket release timestamp with no offset. + voucherGroupId (Guid, required, nullable) - Voucher group ID. + voucherGroupName (string, required, nullable) - Voucher group name. + voucherId (Guid, required, nullable) - Voucher ID. + voucherCode (string, required, nullable) - Voucher code. + voucherDiscount (number, required, nullable) - Voucher discount amount. + discountId (Guid, required, nullable) - Campaign discount ID. + discountName (string, required, nullable) - Campaign discount name. + discountAmount (number, required, nullable) - Campaign discount amount. + giftCardAmount (number, required, nullable) - Gift card amount applied. + giftCardCodes (string, required, nullable) - Applied gift card codes. + orderNumber (string, required, nullable) - Order number. + deliveryMethod (string, required, nullable) - Order delivery method. + reservationLineType (string, required) - Reservation line kind. + entered (boolean, required) - Whether admission was recorded. + enteredTimestamp (string, required, nullable) - Admission timestamp with no offset. + scannedBy (string, required, nullable) - Scanner name. + scannedAt (string, required, nullable) - Entrance used for admission. + posTransferTimestampUtc (string, required, nullable) - POS transfer time stored in UTC but serialized as a timestamp with no offset. + posTransferType (string, required, nullable) - POS transfer type. + posId (string, required, nullable) - POS identifier. + posPluNumber (string, required, nullable) - POS PLU number. + posHandOuts (integer, required, nullable) - Recorded POS handouts. ## MatchReportResult (Envelope) + result (array[MatchReportDataRecord], required) - Match report rows. ## JunuAttendanceDataRecord (object) + id (Guid, required) - Attendance record ID. + ticketTypeId (Guid, required) - Ticket type ID. + eventId (Guid, required) - Event ID. + customerId (Guid, required, nullable) - Customer ID. + timestamp (string, required) - Attendance timestamp with no offset. ## JunuAttendancePage (PagedEnvelope) + data (array[JunuAttendanceDataRecord], required) - Attendance records. ## JunuCustomerDataRecord (object) + id (Guid, required) - Customer ID. + firstName (string, required, nullable) - First name. + lastName (string, required, nullable) - Last name. + fullName (string, required) - Combined first and last name. + email (string, required, nullable) - Email address. + birthdate (string, required, nullable) - Date of birth as a timestamp with no offset. + zipCode (string, required, nullable) - Postal code. + country (string, required, nullable) - Country. + gender (string, required) - Numeric string supplied by the reporting service: `0` = None, `1` = Male, `2` = Female, `3` = Other. ## JunuCustomersPage (PagedEnvelope) + data (array[JunuCustomerDataRecord], required) - Customer records. ## JunuEventDataRecord (object) + id (Guid, required) - Event ID. + name (string, required) - Event name. + date (string, required) - Event start timestamp with no offset. + type (string, required, nullable) - Event type name. + matchId (integer, required) - Match ID. ## JunuEventsPage (PagedEnvelope) + data (array[JunuEventDataRecord], required) - Event records. ## JunuTicketTypeDataRecord (object) + id (Guid, required) - Ticket type ID. + name (string, required) - Ticket type name. ## JunuTicketTypesResult (Envelope) + result (array[JunuTicketTypeDataRecord], required) - Ticket type records. ## JunuTransactionDataRecord (object) + id (Guid, required) - Transaction record ID. + timestamp (string, required) - Transaction timestamp with no offset. + ticketType (Guid, required) - Ticket type ID. + eventId (Guid, required) - Event ID. + customerId (Guid, required, nullable) - Customer ID. + priceCategoryId (Guid, required, nullable) - Price category ID. + priceCategory (string, required, nullable) - Price category name. + price (integer, required) - Price in minor currency units. + cancelled (boolean, required) - Whether the order line is cancelled. + currency (string, required) - Currency code. + tribune (string, required, nullable) - Tribune name. + section (string, required, nullable) - Section name. + entrance (string, required, nullable) - Entrance name. + group (string, required, nullable) - Pricing group. + rowNumber (string, required, nullable) - Seat row. + seatNumber (string, required, nullable) - Seat number. + barcode (string, required, nullable) - Admission barcode. + salesChannel (string, required, nullable) - Sales channel. + paymentGateway (string, required) - Yes when a payment transaction is recorded; otherwise No. + transactionId (string, required, nullable) - Payment transaction ID. ## JunuTransactionsPage (PagedEnvelope) + data (array[JunuTransactionDataRecord], required) - Transaction records. ## AccessCardTypeCountRecord (object) + type (string, required) - Access card type. + entryCount (integer, required) - Measured entries for the type. + source (string, required) - Always measured-entry. + cards (array[AccessCardCountRecord], required) - Counts by card. ## AccessCardCountRecord (object) + name (string, required) - Card label. + entryCount (integer, required) - Measured entries for the card. ## AccessCardCountsResult (Envelope) + result (array[AccessCardTypeCountRecord], required) - Entry counts by access card type. ## AttendanceAdjustmentRecord (object) + id (integer, required) - Adjustment ID. + name (string, required) - Adjustment label. + amount (integer, required) - Manual attendance adjustment; may be negative. + source (string, required) - Always manual. + adjustedBy (string, required) - User who entered the adjustment. + adjustTime (string, required) - Adjustment timestamp with no offset. ## AttendanceAdjustmentsResult (Envelope) + result (array[AttendanceAdjustmentRecord], required) - Manual attendance adjustments. ## ManualUploadReportDataRecord (object) + eventId (integer, required) - Numeric event ID. + eventUniqueidentifier (Guid, required) - Public event ID. + eventName (string, required) - Event name. + eventTime (string, required) - Event start timestamp with no offset. + barcode (string, required) - Uploaded barcode. + sectionId (integer, required) - Numeric section ID. + section (string, required, nullable) - Section name. + uploadedBy (string, required) - User who uploaded the barcode. + uploadTime (string, required) - Upload timestamp with no offset. + entered (boolean, required) - Whether admission was recorded. + enteredTimestamp (string, required, nullable) - Admission timestamp with no offset. + scannedBy (string, required, nullable) - Scanner name. + scannedAt (string, required, nullable) - Entrance used for admission. ## ManualUploadReportResult (Envelope) + result (array[ManualUploadReportDataRecord], required) - Uploaded barcode records. ## StartCampaignsSyncRequest (object) + components (array[string], required) - Select Profiles, Partners, SeasonCards, Subscriptions, TicketSubscriptions, or All; All cannot be combined with other selections. At least one non-empty component is required. ## StartHeyLoyaltySyncRequest (object) + components (array[string], required) - Select Profiles, Partners, SeasonCards, Subscriptions, TicketSubscriptions, or All; All cannot be combined with other selections. At least one non-empty component is required. ## StartKlaviyoSyncRequest (object) + components (array[string], nullable) - Select Profiles, Partners, SeasonCards, Subscriptions, TicketSubscriptions, or All; All cannot be combined with other selections. Defaults to All when omitted or empty. ## CampaignSyncRun (object) + runId (Guid, required) - Run ID; the empty GUID in handler-generated errors. + status (string, required) - Lifecycle: Pending, Running, Failed, or Completed. Handler-generated errors use rejected, running, failed, or the authorization error message. + startedAt (string, required) - Start timestamp. When unset, the serialized value is `0001-01-01T00:00:00` with no offset. + completedAt (DateTime, required, nullable) - Completion timestamp; null until completed or when unset. + profileCount (integer, required) - Number of profiles processed. + seasonCardCount (integer, required) - Number of season tickets processed. + ticketSubscriptionCount (integer, required) - Number of ticket subscriptions processed. + profileCheckpoint (string, required, nullable) - Profile progress checkpoint. + seasonCardCheckpoint (string, required, nullable) - Season ticket progress checkpoint. + ticketSubscriptionCheckpoint (string, required, nullable) - Ticket subscription progress checkpoint. + profilesCompleted (boolean, required) - Whether profile processing is complete. + seasonCardsCompleted (boolean, required) - Whether season ticket processing is complete. + ticketSubscriptionsCompleted (boolean, required) - Whether ticket subscription processing is complete. + failure (string, required, nullable) - Failure detail when available. + components (array[string], required, nullable) - Selected components; null in handler-generated errors. ## HeyLoyaltyHistoricalSyncRun (object) + runId (Guid, required) - Run ID; the empty GUID in handler-generated errors. + status (string, required) - Lifecycle: Pending, Running, Failed, or Queued. Handler-generated errors use rejected, running, failed, or the authorization error message. + startedAt (string, required) - Start timestamp. When unset, the serialized value is `0001-01-01T00:00:00` with no offset. + completedAt (DateTime, required, nullable) - Completion timestamp; null until completed or when unset. + queuedCount (integer, required) - Number of source messages queued. + failure (string, required, nullable) - Failure detail when available. + components (array[string], required, nullable) - Selected components; null in handler-generated errors. ## KlaviyoHistoricalSyncRun (object) + runId (Guid, required) - Run ID; the empty GUID in handler-generated errors. + status (string, required) - Lifecycle: Pending, Running, Failed, or Queued. Handler-generated errors use rejected, running, failed, or the authorization error message. + startedAt (string, required) - Start timestamp. When unset, the serialized value is `0001-01-01T00:00:00` with no offset. + completedAt (DateTime, required, nullable) - Completion timestamp; null until completed or when unset. + queuedCount (integer, required) - Number of source messages queued. + failure (string, required, nullable) - Failure detail when available. + components (array[string], required, nullable) - Selected components; null in handler-generated errors.