Operation

Get inventory

GET/inventory/{id}

Get a specific inventory bucket by ID

Path parameters

idstringRequired: Inventory ID

Query parameters

accountIdstringRequired: Account ID

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/inv_abc123" \  -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"
  }
}

Get inventory

Path parameters

Query parameters

Returns

Errors

Try it in test mode

Path parameters

Query parameters