# Retrieve the full bookable catalogue (paginated, venue-aggregated)

Returns the entire bookable catalogue available to the caller, paginated and
venue-aggregated. Results are grouped by operator (ListingGroup); each group
carries its venues (ListingItem), and each venue carries one Listing per
capability it offers (table_reservation, event_ticket).

A venue that also hosts a ticketed event therefore appears once, with two
entries in its capabilities[] — one per capability. Optional query filters
(capability, name, location, features, date, …) narrow the catalogue; with no
filters the whole catalogue is returned page by page.

Endpoint: GET /v1/listings
Version: 1.0.0
Security: Live, Sandbox

## Header parameters:

  - `X-Correlation-ID` (string)
    Optional ID for cross-system transaction tracking.
    Example: "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA"

  - `X-Partner-Reference` (string)
    Required for Bookable Agents — identifies the partner on whose behalf the request is made.
    Example: "bottomlessbrunch.com"

## Query parameters:

  - `capability` (string)
    Restrict results to a single capability. Venues are still returned
aggregated; only their matching capability entries are included.
    Enum: "table_reservation", "event_ticket"

  - `venueName` (string)
    Filter by listing name — partial, case-insensitive match.
    Example: "dishoom"

  - `operatorName` (string)
    Filter by operator (venue-group / chain) name.
    Example: "stonegate"

  - `city` (string)
    Example: "london"

  - `area` (string)
    Example: "shoreditch"

  - `features` (array)
    Filter by type / feature slugs (matched against types). Comma-separated list.
    Example: ["dog_friendly","live_music"]

  - `date` (string)
    Filter listings that have availability on a specific date (YYYY-MM-DD).
    Example: "2026-06-15"

  - `fields` (string)
    Field selection using Google Fields syntax. Comma-separated list of top-level
Listing fields to include. When omitted, all fields are returned.
    Example: "id,name,capability,location(lat,lng,city),bookableProducts(compositeId,name)"

  - `pageNumber` (integer)

  - `pageSize` (integer)

  - `sortBy` (string)
    Enum: "default", "name", "city", "area", "relevance"

  - `sortDirection` (string)
    Enum: "ASC", "DESC"

## Response 200 fields (application/json):

  - `meta` (object)

  - `meta.currentPage` (integer)
    The current page number based on limit and offset.

  - `meta.pageSize` (integer)
    The number of items returned per page.

  - `meta.totalItems` (integer)
    The total number of items available.

  - `meta.totalPages` (integer)
    The total number of pages.

  - `listings` (array)

  - `listings.groupName` (string, required)
    Operator (venue-group / chain) display name.
    Example: "Stonegate Group"

  - `listings.items` (array, required)
    Venues (and standalone events) belonging to this operator.

  - `listings.items.name` (string, required)
    Venue name, or event name when there is no associated venue.
    Example: "The Crown & Anchor"

  - `listings.items.location` (object,null)
    Physical location. null for virtual listings (e.g. online events).

  - `listings.items.location.street` (string)
    Example: "1 Upper St Martin's Lane"

  - `listings.items.location.area` (string)
    Neighbourhood(s), pipe-separated.
    Example: "Covent Garden|Seven Dials"

  - `listings.items.location.city` (string)
    Example: "London"

  - `listings.items.location.postCode` (string)
    Example: "WC2H 9FB"

  - `listings.items.location.lat` (number)
    Example: 51.513

  - `listings.items.location.lng` (number)
    Example: -0.128

  - `listings.items.location.gPlace` (string)
    Example: "ChIJN1t_tDeuEmsRUsoyG83frY4"

  - `listings.items.capabilities` (array, required)
    The bookable capabilities offered at this venue.

  - `listings.items.capabilities.id` (string, required)
    CompositeId — {VenueGroupId}|{RmsSlug}|{ResourceId}.
    Example: "29|CS|275cc44dd2e2496fba44857c9257443a"

  - `listings.items.capabilities.name` (string, required)
    Example: "The Crown & Anchor"

  - `listings.items.capabilities.operatorName` (string,null)
    Operator (venue-group / chain) display name.
    Example: "Stonegate Group"

  - `listings.items.capabilities.hostedBy` (string,null)
    Name of the venue hosting this listing. Populated for event_ticket
listings whose event is associated with a physical venue (resolved
from Collins); the venue's address is reflected in location.
null when there is no associated venue (e.g. virtual events).
    Example: "The Crown & Anchor"

  - `listings.items.capabilities.capability` (string, required)
    Identifies a booking capability.
    Enum: "table_reservation", "event_ticket"

  - `listings.items.capabilities.types` (array)
    Listing types and feature tag slugs, merged into a single list
(e.g. venue categories like pub, bar plus feature tags like
dog_friendly, live_music).
    Example: ["pub","bar","dog_friendly","live_music"]

  - `listings.items.capabilities.content` (string,null)
    Example: "A traditional gastropub in the heart of Covent Garden, serving seasonal British food and an award-winning cask ale selection."

  - `listings.items.capabilities.faqs` (array,null)
    Operator-managed public-facing FAQ list. Omitted/null when none are configured.
For an event_ticket listing this is inherited from the hosting venue (hostedBy)
when one exists — events have no FAQ list of their own.
    Example: [{"question":"What is your cancellation policy?","answer":"See our **cancellation policy** [here](https://example.com/policy)."}]

  - `listings.items.capabilities.faqs.question` (string,null)
    Example: "What is your cancellation policy?"

  - `listings.items.capabilities.faqs.answer` (string,null)
    Example: "See our **cancellation policy** [here](https://example.com/policy)."

  - `listings.items.capabilities.photos` (array)
    Photo URLs for this capability.
    Example: ["https://cdn.bookabletech.com/venues/29/photos/crown-anchor-front.jpg","https://cdn.bookabletech.com/venues/29/photos/crown-anchor-dining.jpg"]

  - `listings.items.capabilities.phoneNumber` (string,null)
    Example: "+442079461234"

  - `listings.items.capabilities.website` (string,null)
    Example: "https://www.crown-and-anchor.example/"

  - `listings.items.capabilities.availabilityOccurrence` (array)
    Unified temporal description of the listing. Use recurring_with_time
rules for weekly opening hours, specific_dates* for event dates or
holiday closures, date_range* for seasonal availability, etc.
Multiple rules may combine — status: closed overrides status: open.
Rules sharing the same type, status and time window are aggregated:
recurring rules combine their daysOfWeek, specific-date rules combine
their dates.

  - `listings.items.capabilities.availabilityOccurrence.type` (string, required)
    Type of calendar rule:
- date_range: continuous date range
- recurring: weekday/month pattern, no time
- time_based: time window only, applies every day
- specific_dates: explicit list of dates
- specific_dates_with_time: explicit dates with time window
- date_range_with_time: date range with time window
- recurring_with_time: weekday/month pattern with time window
    Enum: "date_range", "recurring", "time_based", "specific_dates", "specific_dates_with_time", "date_range_with_time", "recurring_with_time"

  - `listings.items.capabilities.availabilityOccurrence.description` (string,null)
    Example: "Standard weekday opening hours, kitchen open until 21:30."

  - `listings.items.capabilities.availabilityOccurrence.status` (string)
    open → listing IS available during this rule.
closed → listing IS NOT available during this rule (overrides
an underlying open rule, e.g. a holiday closure).
    Enum: "open", "closed"

  - `listings.items.capabilities.availabilityOccurrence.notes` (string,null)
    Example: "Last seating 21:30."

  - `listings.items.capabilities.availabilityOccurrence.occurrences` (any, required)
    Rule-specific payload — shape determined by type.

  - `listings.items.capabilities.preorders` (object,null)
    Pre-order assets for a listing. Either capability MAY expose packages
and/or menus that can be selected at booking time. null when the
listing does not support pre-orders.

  - `listings.items.capabilities.preorders.packages` (array,null)

  - `listings.items.capabilities.preorders.packages.id` (string, required)
    Example: "3f9a1c20-5b7e-4c1a-9e2d-1a2b3c4d5e6f"

  - `listings.items.capabilities.preorders.packages.price` (number, required)
    Example: 28.5

  - `listings.items.capabilities.preorders.packages.type` (string, required)
    Example: "main"

  - `listings.items.capabilities.preorders.packages.sub_type` (string,null)
    Example: "roast"

  - `listings.items.capabilities.preorders.packages.diet_types` (array)
    Example: ["gluten_free_option"]

  - `listings.items.capabilities.preorders.packages.allergens` (array)
    Example: ["gluten","dairy"]

  - `listings.items.capabilities.preorders.menus` (array,null)

  - `listings.items.capabilities.preorders.menus.items` (array, required)

  - `listings.items.capabilities.preorders.menus.items.packageId` (string, required)
    Example: "c5f70921-2d3e-4b4c-8d9e-4d5e6f708192"

  - `listings.items.capabilities.preorders.menus.items.subType` (string,null)
    Example: "amuse"

  - `listings.items.capabilities.preorders.menus.items.displayOrder` (integer,null)
    Example: 1

  - `listings.items.capabilities.bookableProducts` (array, required)
    All bookable units for this listing. Every entry is a Bookable —
a single unified shape. Capability-specific fields are populated
according to the row's capability.

  - `listings.items.capabilities.bookableProducts.compositeId` (string)
    CompositeId of the bookable unit.
- table_reservation → {VenueGroupId}|{RmsSlug}|{VenueId}|{ProductId}
- event_ticket → {VenueGroupId}|{RmsSlug}|{EventId}|{TicketTypeId}
    Example: "29|CS|275cc44dd2e2496fba44857c9257443a|e4d909c290d0fb1ca068ffaddf22cbd0"

  - `listings.items.capabilities.bookableProducts.timeInterval` (integer,null)
    Example: 30

  - `listings.items.capabilities.bookableProducts.category` (string,null)
    Example: "Dinner"

  - `listings.items.capabilities.bookableProducts.spaces` (array,null)
    Spaces/areas available within this bookable product.

  - `listings.items.capabilities.bookableProducts.spaces.spaceName` (string,null)

  - `listings.items.capabilities.bookableProducts.spaces.floorLocation` (integer,null)
    Floor number (-10 to +10; 0 = ground floor).

  - `listings.items.capabilities.bookableProducts.spaces.facilities` (array,null)
    Facilities available in the space.
    Enum: "Stage", "Private Bar", "Private Toilets", "Soundproof", "Own Street Entrance", "Fixed Seating", "Outside Space", "Can Be Decorated", "DJ Stand", "Suitable for Meetings", "Wheelchair Accessible", "Accessible Toilets", "Projector", "Screen / TV", "Microphone / PA", "Laptop Connection", "Own Sound System", "HDMI / AV", "In-House Lighting", "Sports TV", "Bring Own DJ", "Serves Food", "External Catering Permitted", "Draft Beer", "Cash Bar", "Can Bring Own Cake", "Tea/Coffee Facilities", "Cloakroom", "Smoking Area", "Wifi Available", "Pet Friendly", "Parking", "Air Conditioning"

  - `listings.items.capabilities.bookableProducts.spaces.capacityStanding` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityStanding.min` (integer,null)

  - `listings.items.capabilities.bookableProducts.spaces.capacityStanding.max` (integer,null)

  - `listings.items.capabilities.bookableProducts.spaces.capacitySeated` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityCabaret` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityTheatre` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityBoardroom` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityClassroom` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityUShape` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityBanquet` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.capacityReception` (object,null)
    Min/max capacity range; both bounds are optional.

  - `listings.items.capabilities.bookableProducts.spaces.policies` (object,null)
    All policies for a space, keyed by policy type. An empty/default object means
that policy has not been configured for this space yet.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.enabled` (boolean)

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules` (array)
    Weekly recurring minimum spend rules. Empty array means none configured.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.label` (string,null)

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions` (object)
    Conditions that must all be satisfied for the rule to apply (AND logic).
An empty object means the rule applies without restriction.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.daysOfWeek` (array,null)
    Days of the week (1=Monday, 7=Sunday). Absent means all days.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.months` (array,null)
    Calendar months (1=January, 12=December). Absent means all months.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.dateRange` (object,null)
    Explicit date interval (inclusive, ISO 8601). Does not recur.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.dateRange.from` (string)

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.dateRange.to` (string)

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.conditions.timeRange` (object,null)
    Time window of the booking start time (HH:MM, inclusive, Europe/London).

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.rules.spendValue` (integer,null)
    Minimum spend amount in pence (GBP).

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.overrides` (array)
    Date-specific minimum spend overrides. Empty array means none configured.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.overrides.date` (string)
    The specific calendar date. Also serves as the URL key.

  - `listings.items.capabilities.bookableProducts.spaces.policies.minimumSpend.overrides.timeRange` (object,null)
    Optional time window (Europe/London) the override applies to. Absent means the override covers the whole date. Outside the window, normal rules apply.

  - `listings.items.capabilities.bookableProducts.spaces.policies.occasionTypes` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.occasionTypes.values` (array,null)
    Allowed occasion types.
    Enum: "Christmas Party", "Corporate Event", "Engagement Party", "Funeral/Wake", "Summer Party", "Wedding Party", "Winter Party", "Work Get Together", "Working Breakfast", "Working Lunch", "Working Dinner", "Promoted Event"

  - `listings.items.capabilities.bookableProducts.spaces.policies.under18s` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.under18s.allowed` (boolean,null)
    Whether under-18s are permitted (true) or prohibited (false) in this space.
null means the policy has not been explicitly set.
allowed must not be true when enabled is false.

  - `listings.items.capabilities.bookableProducts.spaces.policies.under18s.until` (string,null)
    Cutoff time for under-18s, e.g. "21:00".

  - `listings.items.capabilities.bookableProducts.spaces.policies.promotedEvents` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.promotedEvents.allowed` (boolean,null)
    Whether promoted events are permitted (true) or prohibited (false) in this space.
null means the policy has not been explicitly set.
allowed must not be true when enabled is false.

  - `listings.items.capabilities.bookableProducts.spaces.policies.promotedEvents.notes` (string,null)
    Optional notes about promoted events at this space.

  - `listings.items.capabilities.bookableProducts.spaces.policies.accessibility` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.accessibility.accessible` (boolean,null)

  - `listings.items.capabilities.bookableProducts.spaces.policies.servesFood` (object)

  - `listings.items.capabilities.bookableProducts.spaces.policies.servesFood.allowed` (boolean,null)
    Whether the space serves food (true) or does not (false).
null means the policy has not been explicitly set.
allowed must not be true when enabled is false.

  - `listings.items.capabilities.bookableProducts.preorders` (object,null)
    Pre-order configuration for the bookable unit.

  - `listings.items.capabilities.bookableProducts.preorders.required` (boolean)
    Whether a pre-order is required to complete the booking.
    Example: true

  - `listings.items.capabilities.bookableProducts.preorders.requiredType` (string,null)
    Type of asset the pre-order must reference.
Only meaningful when required: true — otherwise null.
    Enum: "package", "menu", "any"

  - `listings.items.capabilities.bookableProducts.preorders.packageIds` (array,null)
    Example: ["3f9a1c20-5b7e-4c1a-9e2d-1a2b3c4d5e6f","8c2d4e60-9a1b-4f3c-8d2e-2b3c4d5e6f70"]

  - `listings.items.capabilities.bookableProducts.preorders.menuIds` (array,null)
    Example: ["b4e6f810-1c2d-4a3b-9c8d-3c4d5e6f7081"]

  - `listings.items.capabilities.bookableProducts.deposit` (object,null)
    Deposit configuration for the bookable unit.

  - `listings.items.capabilities.bookableProducts.deposit.required` (boolean)
    Whether a deposit is required to confirm the booking.
    Example: true

  - `listings.items.capabilities.bookableProducts.deposit.rule` (object,null)

  - `listings.items.capabilities.bookableProducts.deposit.rule.perAdult` (number,null)
    Example: 10

  - `listings.items.capabilities.bookableProducts.deposit.rule.perChild` (number,null)
    Example: 5

  - `listings.items.capabilities.bookableProducts.deposit.rule.perBooking` (number,null)

  - `listings.items.capabilities.bookableProducts.autoConfirmRule` (object)

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.date` (string,null)
    Example: "2026-06-15"

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.dateType` (string,null)
    Example: "weekday"

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.minPeople` (integer,null)
    Example: 1

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.maxPeople` (integer,null)
    Example: 6

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.timeFrom` (string,null)
    Example: "12:00"

  - `listings.items.capabilities.bookableProducts.autoConfirmRule.timeTo` (string,null)
    Example: "22:30"

  - `listings.items.capabilities.bookableProducts.noAvailabilityAction` (string,null)
    Example: "waitlist"

  - `listings.items.capabilities.bookableProducts.price` (object,null)
    Monetary amount with currency.

  - `listings.items.capabilities.bookableProducts.price.amount` (number, required)
    Example: 25

  - `listings.items.capabilities.bookableProducts.price.currency` (string, required)
    ISO 4217 currency code.
    Example: "GBP"

  - `listings.items.capabilities.bookableProducts.capacity` (object,null)
    Capacity for a ticket type.

  - `listings.items.capabilities.bookableProducts.capacity.max` (integer,null)
    Maximum capacity.
    Example: 300

  - `listings.items.capabilities.bookableProducts.capacity.remaining` (integer,null)
    Remaining capacity.
    Example: 142

  - `listings.items.capabilities.bookableProducts.visibility` (string,null)
    Example: "on_sale"

  - `listings.items.capabilities.bookableProducts.availabilityOccurrenceOverrides` (array,null)
    Bookable-scoped CalendarRule entries that refine or restrict the
listing-level availabilityOccurrence for this specific bookable unit (event
sessions, exceptional dates, closures, …). Same shape as
Listing.availabilityOccurrence; status: closed overrides status: open.

## Response 400 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "VALID-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

  - `errors` (object,null)
    Validation errors dictionary mapping field names to arrays of error messages. Only present for validation errors (VALID-N-001).
    Example: {"Date":["Availability date cannot be in the past."],"EndTime":["EndTime must be after StartTime."]}

## Response 401 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "VALID-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

  - `errors` (object,null)
    Validation errors dictionary mapping field names to arrays of error messages. Only present for validation errors (VALID-N-001).
    Example: {"Date":["Availability date cannot be in the past."],"EndTime":["EndTime must be after StartTime."]}

## Response 403 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "VALID-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

  - `errors` (object,null)
    Validation errors dictionary mapping field names to arrays of error messages. Only present for validation errors (VALID-N-001).
    Example: {"Date":["Availability date cannot be in the past."],"EndTime":["EndTime must be after StartTime."]}

## Response 429 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "VALID-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

  - `errors` (object,null)
    Validation errors dictionary mapping field names to arrays of error messages. Only present for validation errors (VALID-N-001).
    Example: {"Date":["Availability date cannot be in the past."],"EndTime":["EndTime must be after StartTime."]}

## Response 500 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "BOOK-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

## Response 503 fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "BOOK-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"

## Response default fields (application/json):

  - `type` (string)
    A URI reference [rfc9457] that identifies the problem type. This specification encourages that, when dereferenced, it provides human-readable documentation for the problem type (e.g., using HTML [W3C.REC-html5-20141028]). When this member is not present, its value is assumed to be "about:blank".

  - `title` (string, required)
    A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.

  - `status` (integer, required)
    The HTTP status code [rfc9457, Section 3.1.12] generated by the origin server for this occurrence of the problem.

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem.

  - `code` (string, required)
    Error code in the format RESOURCE-X-NNN where X is R (retryable) or N (non-retryable). See ErrorCatalog.md for all error codes.
    Example: "BOOK-N-001"

  - `isRetryable` (boolean, required)
    Indicates whether the error is retryable. If true, the request may succeed if retried. If false, the request will fail again with the same input.

  - `traceId` (string)
    Request trace identifier for debugging and correlation purposes.
    Example: "0HNJ2BG2TU3BU:00000001"