Retrieve a participant type

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

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

Returns a single active participant type by id, including its computed isEnabledOnBookableOptions flag. Soft-deleted types and types of other experiences return 404.

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

Path parameters

  • experienceIdstring (uuid)required

    UUID of the parent experience.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • participantTypeIdstring (uuid)required

    UUID of the participant type (must belong to the experience in the path).

    Example:
    a7c53f01-6f9c-4d1c-9c30-1c19a1a5bd44

Query parameters

  • languagestring

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

    Example:
    de

Responses

200object

The participant type.

  • 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
{
  "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.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

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."
    }
  ]
}