Skip to main content

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 FieldSOAP FieldNotes
eventIdID_CatalogEvent unique identifier
labelLabelEvent name/title
startDateDateStartEvent start date (ISO 8601)
endDateDateEndEvent end date (ISO 8601)
venueNameVenueNameVenue name
venueIdID_VenueVenue identifier
venueAddressVenue_AddressFull physical address of the venue
commentCommentAdditional comments or notes
producerNameProducerNameProducer name
producerLicenceProducerLicenceProducer license number
statusStatusEvent status code

Request

Responses

OK