List participant types of an experience

GET/v2/experiences/{experienceId}/participant-types

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

Returns all active participant types of the experience, ordered by sortOrder. Reads are public to API-key callers. Every row carries the computed isEnabledOnBookableOptions flag: true only when at least one ACTIVE, non-custom option of the experience does not disable the type and has at least one future bookable availability slot — i.e. the type is actually purchasable right now. Use it to hide dead types from guest-facing pickers while still showing organizers the complete list.

Requestbash
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/participant-types" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f

Query parameters

  • languagestring

    Two-letter language code. When present, multilingual fields collapse from full language objects to plain strings in that language.

    Example:
    de
  • pageinteger

    Page number (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Items per page (default 50). Note the snake_case wire name.

    Default:
    50
    Example:
    50
  • nopaginationboolean

    Set to true to disable pagination and return the bare array of results.

    Default:
    false
    Example:
    false

Responses

200object

Paginated list of participant types.

  • countinteger

    Total number of participant types.

    Example:
    3
  • nextstringnullable

    Absolute URL of the next page, or null on the last page.

  • previousstringnullable

    Absolute URL of the previous page, or null on the first page.

  • resultsobject[]

    Participant types on this page, ordered by sortOrder.

    Child fields
    • idstring (uuid)

      Participant type id.

      Example:
      a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44
    • experienceIdstring (uuid)read-only

      The parent experience id.

      Example:
      8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
    • namemap of stringnullable

      Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

    • descriptionmap of stringnullable

      Multilingual text keyed by 2-letter language code. Returned as this full object by default; collapses to a plain string when the language query parameter is used.

    • minAgeintegernullable

      Minimum age (inclusive), or null when unbounded.

      Example:
      18
    • maxAgeintegernullable

      Maximum age (inclusive), or null when unbounded.

    • capacityExemptboolean

      When true, participants of this type (e.g. infants) do not count toward slot or variant capacity.

      Example:
      false
    • sortOrderinteger

      Display position (ascending).

      Example:
      0
    • isDefaultboolean

      True for the seeded Adult/Child/Infant types. Default types cannot be deleted and only their age range can be edited.

      Example:
      true
    • externalIdstringnullable

      External provider identifier when synced from Bokun/Regiondo/Kompas.

    • isEnabledOnBookableOptionsbooleanread-only

      Computed: true when at least one ACTIVE, non-custom option of the experience enables this type AND has a future bookable availability slot — i.e. a guest could actually book it right now.

      Example:
      true
Response 200json
{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44",
      "experienceId": "8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f",
      "name": {
        "en": "Shared boat tour",
        "de": "Gemeinsame Bootstour"
      },
      "description": {
        "en": "Shared boat tour",
        "de": "Gemeinsame Bootstour"
      },
      "minAge": 18,
      "maxAge": null,
      "capacityExempt": false,
      "sortOrder": 0,
      "isDefault": true,
      "externalId": null,
      "isEnabledOnBookableOptions": true
    }
  ]
}

Errors

401

Missing or invalid X-API-Key header.

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 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}