Bookings

Create, confirm, update, and cancel bookings. The booking flow is: reserve → confirm. Reservations expire if not confirmed within the specified time.

List bookings

get

Returns a list of bookings filtered by the specified parameters.

Important: At least one filter parameter is required. You must provide one of:

• resellerReference - Filter by your reference

• supplierReference - Filter by our booking ID

• localDate - Filter by a specific date

• localDateStart AND localDateEnd - Filter by date range (both required together)

Calling this endpoint without any filter parameters will return a 400 BAD_REQUEST error.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Query parameters

resellerReferencestringOptional

Filter by reseller reference (your booking reference)

supplierReferencestringOptional

Filter by supplier reference (our booking ID)

localDatestring · dateOptional

Filter by specific date (bookings occurring on this date)

Example: 2025-01-15

localDateStartstring · dateOptional

Filter by start date - must be used together with localDateEnd

Example: 2025-01-01

localDateEndstring · dateOptional

Filter by end date - must be used together with localDateStart

Example: 2025-01-31

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Responses

200

List of bookings matching the filter criteria

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Bad request - no filter parameter provided. Must include one of: resellerReference, supplierReference, localDate, or localDateStart/localDateEnd

application/json

401

Unauthorized

get

/bookings

HTTPcURLJavaScriptPython

GET /octo/v1/bookings HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Accept: */*

[
  {
    "id": "text",
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "testMode": true,
    "resellerReference": "text",
    "supplierReference": "text",
    "status": "ON_HOLD",
    "utcCreatedAt": "2026-02-18T17:49:47.043Z",
    "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
    "utcExpiresAt": "2026-02-18T17:49:47.043Z",
    "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
    "productId": "text",
    "product": {
      "id": "42",
      "internalName": "Bike Tour",
      "reference": "text",
      "locale": "sv",
      "timeZone": "Europe/Stockholm",
      "availabilityType": "START_TIME",
      "deliveryFormats": "PDF_URL",
      "deliveryMethods": [
        "text"
      ],
      "options": [
        {
          "id": "DEFAULT",
          "default": true,
          "internalName": "text",
          "restrictions": {},
          "units": [
            {
              "id": "ADULT_15",
              "internalName": "Adult ticket",
              "reference": "text",
              "type": "ADULT",
              "restrictions": {},
              "requiredContactFields": [
                "text"
              ],
              "pricingFrom": [
                {
                  "original": 10000,
                  "retail": 10000,
                  "net": 8000,
                  "currency": "SEK",
                  "currencyPrecision": 2,
                  "includedTaxes": [
                    {
                      "name": "VAT",
                      "retail": 2000,
                      "net": 1600
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "extras": [
        {
          "id": "123",
          "internalName": "Helmet Rental",
          "reference": "HELMET-001",
          "restrictions": {
            "minQuantity": 0,
            "maxQuantity": 10
          },
          "pricingFrom": [
            {
              "original": 10000,
              "retail": 10000,
              "net": 8000,
              "currency": "SEK",
              "currencyPrecision": 2,
              "includedTaxes": [
                {
                  "name": "VAT",
                  "retail": 2000,
                  "net": 1600
                }
              ]
            }
          ],
          "title": "Safety Helmet Rental",
          "description": "High-quality safety helmet for your adventure"
        }
      ],
      "title": "text",
      "shortDescription": "text",
      "pricingFrom": [
        {
          "original": 10000,
          "retail": 10000,
          "net": 8000,
          "currency": "SEK",
          "currencyPrecision": 2,
          "includedTaxes": [
            {
              "name": "VAT",
              "retail": 2000,
              "net": 1600
            }
          ]
        }
      ]
    },
    "optionId": "text",
    "option": {},
    "availabilityId": "text",
    "availability": {
      "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
      "localDateTimeStart": "2025-01-15T10:00:00+01:00",
      "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
      "allDay": false
    },
    "contact": {
      "fullName": "John Doe",
      "firstName": "John",
      "lastName": "Doe",
      "emailAddress": "[email protected]",
      "phoneNumber": "[phone]",
      "locales": [
        "sv",
        "en"
      ],
      "country": "SE",
      "notes": "text"
    },
    "notes": "text",
    "deliveryMethods": [
      "text"
    ],
    "voucher": {
      "redemptionMethod": "DIGITAL",
      "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
      "deliveryOptions": [
        {
          "deliveryFormat": "PDF_URL",
          "deliveryValue": "text"
        }
      ]
    },
    "unitItems": [
      {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "resellerReference": "text",
        "supplierReference": "text",
        "unitId": "ADULT_15",
        "unit": {},
        "status": "text",
        "utcRedeemedAt": "text",
        "contact": {
          "fullName": "text",
          "firstName": "text",
          "lastName": "text",
          "emailAddress": "text",
          "phoneNumber": "text",
          "locales": [
            "text"
          ],
          "country": "text",
          "notes": "text"
        },
        "ticket": {
          "redemptionMethod": "DIGITAL",
          "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
          "deliveryOptions": [
            {
              "deliveryFormat": "PDF_URL",
              "deliveryValue": "text"
            }
          ]
        }
      }
    ],
    "extraItems": [
      {
        "extraId": "123"
      }
    ],
    "pricing": {
      "original": 1,
      "retail": 1,
      "net": 1,
      "currency": "text",
      "currencyPrecision": 1,
      "includedTaxes": [
        {
          "name": "VAT",
          "retail": 2000,
          "net": 1600
        }
      ]
    }
  }
]

Create a booking reservation

post

Creates a new booking reservation. Include extraItems in unitItems when using the extras capability.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing, extras)

Example: pricing,extras

Body

application/json

Request body for creating a booking reservation

uuidstring · uuidOptional

Optional UUID for idempotency

productIdstringRequired

Product ID to book

Example: 42

optionIdstringRequired

Option ID

Example: DEFAULT

availabilityIdstringRequired

Availability slot ID from availability check

Example: 2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00

expirationMinutesintegerOptional

Minutes until reservation expires

Example: 30

notesstringOptional

Booking notes

Responses

200

Booking reservation created

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid product ID or validation error

application/json

401

Unauthorized

post

/bookings

HTTPcURLJavaScriptPython

POST /octo/v1/bookings HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing,extras
Content-Type: application/json
Accept: */*
Content-Length: 461

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "productId": "42",
  "optionId": "DEFAULT",
  "availabilityId": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
  "expirationMinutes": 30,
  "notes": "text",
  "unitItems": [
    {
      "unitId": "ADULT_15",
      "quantity": 2
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  }
}

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}

Confirm a booking

post

Confirms a pending booking reservation.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Path parameters

uuidstring · uuidRequired

Booking UUID

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Body

application/json

notesstringOptional

Responses

200

Booking confirmed

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid booking UUID or already confirmed

application/json

401

Unauthorized

post

/bookings/{uuid}/confirm

HTTPcURLJavaScriptPython

POST /octo/v1/bookings/{uuid}/confirm HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text"
}

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}

Cancel a booking

post

Cancels a booking reservation or confirmed booking.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Path parameters

uuidstring · uuidRequired

Booking UUID

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Body

application/json

reasonstringOptional

Responses

200

Booking cancelled

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid booking UUID

application/json

401

Unauthorized

post

/bookings/{uuid}/cancel

HTTPcURLJavaScriptPython

POST /octo/v1/bookings/{uuid}/cancel HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "reason": "text"
}

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}

Get a booking

get

Returns details for a specific booking including any extras.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Path parameters

uuidstring · uuidRequired

Booking UUID

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Responses

200

Booking details

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid booking UUID

application/json

401

Unauthorized

get

/bookings/{uuid}

HTTPcURLJavaScriptPython

GET /octo/v1/bookings/{uuid} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Accept: */*

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}

Update a booking

patch

Updates contact information or notes on a booking.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Path parameters

uuidstring · uuidRequired

Booking UUID

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Body

application/json

notesstringOptional

Responses

200

Booking updated

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid booking UUID

application/json

401

Unauthorized

patch

/bookings/{uuid}

HTTPcURLJavaScriptPython

PATCH /octo/v1/bookings/{uuid} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text"
}

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}

Extend booking reservation

patch

Extends the expiration time of a pending booking reservation.

Authorizations

bearerAuth

AuthorizationstringRequired

OCTO API Bearer token authentication

Path parameters

uuidstring · uuidRequired

Booking UUID

Header parameters

Octo-CapabilitiesstringRequired

Comma-separated list of capabilities (pricing)

Example: pricing

Body

application/json

expirationMinutesintegerRequired

Number of minutes from now until expiration

Example: 30

Responses

200

Booking reservation extended

application/json

A booking in the OCTO system

idstringRequired

Internal booking ID

uuidstring · uuidRequired

Unique booking identifier

testModebooleanOptional

Whether this is a test booking

resellerReferencestring · nullableOptional

Reseller reference number

supplierReferencestringOptional

Supplier reference number

statusstring · enumRequired

Booking status

Possible values:

utcCreatedAtstring · date-timeOptional

Creation time in UTC

utcUpdatedAtstring · date-time · nullableOptional

utcExpiresAtstring · date-time · nullableOptional

Expiration time for pending bookings

utcConfirmedAtstring · date-time · nullableOptional

productIdstringOptional

Product ID

productone of · nullableOptional

optionIdstringOptional

Option ID

optionobject · nullableOptional

availabilityIdstringOptional

Availability slot ID (format: startDateTime|endDateTime)

availabilityone of · nullableOptional

Availability details for the booking

notesstring · nullableOptional

deliveryMethodsstring[]Optional

Delivery methods matching product delivery formats

voucherone of · nullableOptional

Voucher details for the booking

pricingone of · nullableOptional

Total pricing (requires pricing capability)

400

Invalid booking UUID or already confirmed

application/json

401

Unauthorized

patch

/bookings/{uuid}/extend

HTTPcURLJavaScriptPython

PATCH /octo/v1/bookings/{uuid}/extend HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Octo-Capabilities: pricing
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "expirationMinutes": 30
}

{
  "id": "text",
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "testMode": true,
  "resellerReference": "text",
  "supplierReference": "text",
  "status": "ON_HOLD",
  "utcCreatedAt": "2026-02-18T17:49:47.043Z",
  "utcUpdatedAt": "2026-02-18T17:49:47.043Z",
  "utcExpiresAt": "2026-02-18T17:49:47.043Z",
  "utcConfirmedAt": "2026-02-18T17:49:47.043Z",
  "productId": "text",
  "product": {
    "id": "42",
    "internalName": "Bike Tour",
    "reference": "text",
    "locale": "sv",
    "timeZone": "Europe/Stockholm",
    "availabilityType": "START_TIME",
    "deliveryFormats": "PDF_URL",
    "deliveryMethods": [
      "text"
    ],
    "options": [
      {
        "id": "DEFAULT",
        "default": true,
        "internalName": "text",
        "restrictions": {},
        "units": [
          {
            "id": "ADULT_15",
            "internalName": "Adult ticket",
            "reference": "text",
            "type": "ADULT",
            "restrictions": {},
            "requiredContactFields": [
              "text"
            ],
            "pricingFrom": [
              {
                "original": 10000,
                "retail": 10000,
                "net": 8000,
                "currency": "SEK",
                "currencyPrecision": 2,
                "includedTaxes": [
                  {
                    "name": "VAT",
                    "retail": 2000,
                    "net": 1600
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "extras": [
      {
        "id": "123",
        "internalName": "Helmet Rental",
        "reference": "HELMET-001",
        "restrictions": {
          "minQuantity": 0,
          "maxQuantity": 10
        },
        "pricingFrom": [
          {
            "original": 10000,
            "retail": 10000,
            "net": 8000,
            "currency": "SEK",
            "currencyPrecision": 2,
            "includedTaxes": [
              {
                "name": "VAT",
                "retail": 2000,
                "net": 1600
              }
            ]
          }
        ],
        "title": "Safety Helmet Rental",
        "description": "High-quality safety helmet for your adventure"
      }
    ],
    "title": "text",
    "shortDescription": "text",
    "pricingFrom": [
      {
        "original": 10000,
        "retail": 10000,
        "net": 8000,
        "currency": "SEK",
        "currencyPrecision": 2,
        "includedTaxes": [
          {
            "name": "VAT",
            "retail": 2000,
            "net": 1600
          }
        ]
      }
    ]
  },
  "optionId": "text",
  "option": {},
  "availabilityId": "text",
  "availability": {
    "id": "2025-01-15T10:00:00+01:00|2025-01-15T12:00:00+01:00",
    "localDateTimeStart": "2025-01-15T10:00:00+01:00",
    "localDateTimeEnd": "2025-01-15T12:00:00+01:00",
    "allDay": false
  },
  "contact": {
    "fullName": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "emailAddress": "[email protected]",
    "phoneNumber": "[phone]",
    "locales": [
      "sv",
      "en"
    ],
    "country": "SE",
    "notes": "text"
  },
  "notes": "text",
  "deliveryMethods": [
    "text"
  ],
  "voucher": {
    "redemptionMethod": "DIGITAL",
    "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
    "deliveryOptions": [
      {
        "deliveryFormat": "PDF_URL",
        "deliveryValue": "text"
      }
    ]
  },
  "unitItems": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "resellerReference": "text",
      "supplierReference": "text",
      "unitId": "ADULT_15",
      "unit": {},
      "status": "text",
      "utcRedeemedAt": "text",
      "contact": {
        "fullName": "text",
        "firstName": "text",
        "lastName": "text",
        "emailAddress": "text",
        "phoneNumber": "text",
        "locales": [
          "text"
        ],
        "country": "text",
        "notes": "text"
      },
      "ticket": {
        "redemptionMethod": "DIGITAL",
        "utcRedeemedAt": "2026-02-18T17:49:47.043Z",
        "deliveryOptions": [
          {
            "deliveryFormat": "PDF_URL",
            "deliveryValue": "text"
          }
        ]
      }
    }
  ],
  "extraItems": [
    {
      "extraId": "123"
    }
  ],
  "pricing": {
    "original": 1,
    "retail": 1,
    "net": 1,
    "currency": "text",
    "currencyPrecision": 1,
    "includedTaxes": [
      {
        "name": "VAT",
        "retail": 2000,
        "net": 1600
      }
    ]
  }
}