Skip to content
Docs
Operation

List inventory

GET/inventory
List all inventory buckets for the organisation with optional filtering

Query parameters

sourceTypestringOptional
Type of inventory source
eventOccurrenceIdstringOptional
eventIdstringOptional
productIdstringOptional
isAllocatedstringOptional

Returns

Inventory retrieved 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 GET "https://api.ticketlayer.com/v1/inventory" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug"
Response 200
{
  "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"
    }
  ]
}

Try it in test mode

Query parameters
Type of inventory source