Distinct filter values for the caller's bookings

GET/v2/bookings/available-filters

Requires your API key in the X-API-Key header.

Returns the de-duplicated sets of experiences, stores, agent names, resellers and organizers that appear across the bookings visible to the caller — used to populate the bookings-page filter dropdowns. Honors the same query filters as the list endpoint, so the options can be narrowed to a filtered subset.

Requestbash
curl "https://api.turneo.co/v2/bookings/available-filters" \
  -H "X-API-Key: <your-api-key>"

Responses

200object

Distinct filter options.

  • experienceobject[]

    Experiences that appear in the caller's bookings.

    Child fields
    • idstring (uuid)

      Experience UUID.

      Example:
      9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f
    • namestring

      Experience name in the booking's language.

      Example:
      Split Old Town Walking Tour
  • storeobject[]

    Stores that appear in booking metadata.

    Child fields
    • idstring

      Store ID.

      Example:
      store-123
    • namestring

      Store display name ("" when unknown).

      Example:
      Lobby Desk
  • agentNamestring[]

    Sorted distinct concierge agent names.

  • resellerobject[]

    Resellers that appear in the caller's bookings.

    Child fields
    • idstring

      Reseller partner ID.

      Example:
      hotel-adriatic
    • namestring

      Reseller name.

      Example:
      Hotel Adriatic
  • organizerobject[]

    Organizers that appear in the caller's bookings.

    Child fields
    • idstring

      Organizer partner ID.

      Example:
      split-tours
    • namestring

      Organizer name.

      Example:
      Split Tours
Response 200json
{
  "experience": [
    {
      "id": "9b2e6c7d-1f2a-4b3c-8d9e-0a1b2c3d4e5f",
      "name": "Split Old Town Walking Tour"
    }
  ],
  "store": [
    {
      "id": "store-123",
      "name": "Lobby Desk"
    }
  ],
  "agentName": [
    "Marta",
    "Niko"
  ],
  "reseller": [
    {
      "id": "hotel-adriatic",
      "name": "Hotel Adriatic"
    }
  ],
  "organizer": [
    {
      "id": "split-tours",
      "name": "Split Tours"
    }
  ]
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

403

The API key is valid but not allowed to perform this action on this resource.

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}