List resendable emails for a booking

GET/v2/bookings/{id}/available-emails

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

Returns every resendable email type with a flag indicating whether it can currently be sent for this booking, and a human-readable reason when it cannot. Availability depends on the booking's state:

  • guest_confirmation — booking must be ACCEPTED
  • guest_review — booking must be COMPLETED
  • guest_alternatives — booking must be PENDING with alternatives offered
  • organizer_confirmation — booking must be PENDING
  • organizer_accepted — booking must be ACCEPTED

Use the returned id values as the emailType for POST /v2/bookings/resend-email.

Requestbash
curl "https://api.turneo.co/v2/bookings/0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c/available-emails" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • idstringrequired

    Booking UUID or booking code.

    Example:
    0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c

Responses

200object[]

The list of email types (always all five, with availability flags).

  • idstring

    Email type identifier — pass as emailType to the resend endpoint.

    Allowed values:
    guest_confirmationguest_reviewguest_alternativesorganizer_confirmationorganizer_accepted
    Example:
    guest_confirmation
  • namestring

    Human-readable email name.

    Example:
    Guest Confirmation
  • descriptionstring

    Short description of what the email is.

    Example:
    Send guest confirmation email
  • availableboolean

    Whether this email can currently be sent for the booking.

    Example:
    true
  • reasonstringnullable

    Why the email is unavailable. Null when available is true.

Response 200json
[
  {
    "id": "guest_confirmation",
    "name": "Guest Confirmation",
    "description": "Send guest confirmation email",
    "available": true,
    "reason": null
  }
]

Errors

401

Missing or invalid X-API-Key header.

403

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

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