Operation

Create inventory

POST/inventory

Create a new inventory bucket for tracking capacity

Headers

Idempotency-KeystringOptional: Makes the write safe to retry. The first request with a key does the work and its response is stored for 24 hours; a repeat with the same key and the same request (method, path, query, X-Ticketlayer-Channel, TL-Version and body) gets that stored status and body back, marked `Idempotent-Replay: true`, without running again. The key is scoped to your organisation and your credential. The same key with a different request is 422 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running waits for it, then answers 409 IDEMPOTENT_REQUEST_IN_PROGRESS if it has not finished. Only a 2xx is stored: after an error the key is free again. Omit the header and the request behaves as it always has.

Body

sourceType*"event_occurrence_area" | "product"Type of inventory source

eventIdstringEvent ID (required for event_occurrence_area)

eventOccurrenceIdstringEvent occurrence ID (required for event_occurrence_area)

eventLayoutAreaIdstringEvent layout area ID (required for event_occurrence_area)

productIdstringProduct ID (required for product)

totalCapacity*integerTotal capacity for this inventory

isAllocatedbooleanWhether this inventory has allocated seating

metadataobjectAdditional metadata

accountId*stringAccount ID for the inventory

Returns

Inventory created successfully

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

curl -X POST "https://api.ticketlayer.com/v1/inventory" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug" \  -H "Content-Type: application/json" \  -d '{    "sourceType": "event_occurrence_area",    "eventId": "evt_abc123",    "eventOccurrenceId": "evo_abc123",    "eventLayoutAreaId": "ela_abc123",    "productId": "prd_abc123",    "totalCapacity": 100,    "isAllocated": false,    "metadata": {},    "accountId": "acc_def456"  }'

Response 201

{
  "inventory": {
    "id": "inv_abc123",
    "organisationId": "org_xyz789",
    "accountId": "acc_def456",
    "sourceType": "event_occurrence_area",
    "eventId": "evt_ghi789",
    "eventOccurrenceId": "evo_jkl012",
    "eventLayoutAreaId": "ela_mno345",
    "productId": "prd_pqr678",
    "totalCapacity": 500,
    "available": 450,
    "reserved": 30,
    "confirmed": 20,
    "held": 0,
    "isAllocated": false,
    "version": 1,
    "metadata": null,
    "createdAt": "2024-12-28T10:30:00Z",
    "updatedAt": "2024-12-28T14:45:00Z"
  }
}

Create inventory

Headers

Body

Returns

Errors

Try it in test mode

Body