Retrieves catalog events within a specified date range
GET/api/v1/catalog/events
Fetches all active events from the catalog within a specified date range. Allows optional filtering by venue or specific event IDs. Used to display the catalog of available events for sale.
SOAP Equivalent: AWSP_CatalogGetList
Examples
Success (200)
{
"events": [
{
"eventId": 12345,
"label": "Concert de Jazz",
"startDate": "2026-03-15T20:00:00Z",
"endDate": "2026-03-15T23:00:00Z",
"venueName": "Salle Pleyel",
"venueId": 101,
"venueAddress": "252 Rue du Faubourg Saint-Honoré, 75008 Paris",
"comment": "Exceptional evening",
"producerName": "Jazz Productions",
"producerLicence": "SACEM-12345",
"status": 1
}
]
}
Error 400 - Missing x-tenant header
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "The x-tenant header is required"
}
Error 400 - Validation failed
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "Bad Request",
"status": 400,
"detail": "DateFrom must be before or equal to DateTo"
}
Error 500 - Server error
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.6.1",
"title": "Internal Server Error",
"status": 500,
"detail": "An unexpected error occurred",
"traceId": "00-abc123-def456-00"
}
SOAP to REST Field Mapping
| REST Field | SOAP Field | Notes |
|---|---|---|
| eventId | ID_Catalog | Event unique identifier |
| label | Label | Event name/title |
| startDate | DateStart | Event start date (ISO 8601) |
| endDate | DateEnd | Event end date (ISO 8601) |
| venueName | VenueName | Venue name |
| venueId | ID_Venue | Venue identifier |
| venueAddress | Venue_Address | Full physical address of the venue |
| comment | Comment | Additional comments or notes |
| producerName | ProducerName | Producer name |
| producerLicence | ProducerLicence | Producer license number |
| status | Status | Event status code |
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
- 503
OK
Bad Request
Unauthorized
Forbidden
Not Found
Unprocessable Content
Internal Server Error
Service Unavailable