{
    "openapi": "3.0.3",
    "info": {
        "title": "MyTourist API",
        "version": "1.0",
        "description": "REST API of MyTourist. Send your API token in the Authorization header as a Bearer token. Documentation: https://app.mytourist.cloud/api/docs"
    },
    "servers": [
        {
            "url": "https://app.mytourist.cloud/api/v1"
        }
    ],
    "components": {
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "scheme": "bearer"
            }
        }
    },
    "security": [
        {
            "bearerAuth": []
        }
    ],
    "tags": [
        {
            "name": "Property",
            "description": "General address and company data of the company profile that belongs to the API token."
        },
        {
            "name": "Bookings",
            "description": "Add and manage bookings. When you create a booking, MyTourist automatically creates the invoice and attaches the debtor. Bookings placed by other connected channels are partly locked."
        },
        {
            "name": "Availability",
            "description": "Check which roomtypes are available in a date range, with the calculated total logies price per price rate. With this result you have enough data to create a booking."
        },
        {
            "name": "Calendar",
            "description": "The MyTourist calendar is the central place where it all comes together: bookings, price rates, available rooms and restrictions like minimum and maximum stay and closed for arrival or departure."
        },
        {
            "name": "Debtors",
            "description": "Manage your debtors: the guests and companies that book and pay."
        },
        {
            "name": "Invoices",
            "description": "By default, MyTourist creates an invoice for each booking and calculates the logies price, tourist tax and fixed products. You can also create single invoices without a booking, for example for boat or bike rentals, a bar or activities. With these endpoints you manage invoices, product lines and payments."
        },
        {
            "name": "Roomtypes",
            "description": "Roomtypes are groups of rooms, like \"Doubleroom\" with \"Room 6, 1st floor\" and \"Room 4, 3rd floor\". A B&B often has one room per roomtype, with the same name. Roomtypes and rooms are managed in MyTourist; via the API you can read them."
        },
        {
            "name": "Price rates",
            "description": "Each roomtype has its own price rates. You can have as many as you want, for example weekend arrangements or long and short stay rates. Price rates can be connected to channels like Booking.com."
        },
        {
            "name": "Tax rates",
            "description": "Manage your VAT rates: a label, the rate itself and its type. Tax rates rarely change, but you *can* manage them via the API."
        },
        {
            "name": "Products",
            "description": "Products can be added to invoices, or offered as extras in your booking engine. You can also add a product to each booking automatically, for example final cleaning, and calculate the price per guest and/or per night."
        },
        {
            "name": "Product categories",
            "description": "Keep a clear overview of your products with categories. A category has a name and a color, and is only visible to you, not to your guests."
        },
        {
            "name": "Vouchers",
            "description": "Guests can use vouchers and discount codes to book with a discount in the booking engine. With these endpoints you create, change and delete them."
        }
    ],
    "paths": {
        "/property": {
            "get": {
                "tags": [
                    "Property"
                ],
                "summary": "Retrieve property data",
                "operationId": "propertyGet",
                "description": "Returns the address, contact and bank details of the company profile.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "unique": "12410123",
                                    "name": "MyTourist BV",
                                    "street": "Meetkamp 4",
                                    "zipcode": "7078AJ",
                                    "city": "Megchelen",
                                    "country": "NL",
                                    "website": "mytourist.cloud",
                                    "email": "info@mytourist.cloud",
                                    "phone": null,
                                    "mobile": "06xxxxxxxx",
                                    "currency": "EUR",
                                    "iban_name": "MyTourist",
                                    "iban": "NL00AAAA0123456",
                                    "bic": "NLMT01",
                                    "iban_alt_name": null,
                                    "iban_alt": null,
                                    "bic_alt": null,
                                    "company_id": "12345678",
                                    "registration_id": "987654321",
                                    "custom_coordinates": false
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "unique": {
                                            "type": "string",
                                            "description": "ID of the company profile."
                                        },
                                        "name": {
                                            "type": "string",
                                            "description": "Company name."
                                        },
                                        "street": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Street and house number."
                                        },
                                        "zipcode": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "city": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "country": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ISO 3166-1 alpha-2."
                                        },
                                        "website": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "email": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "phone": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "mobile": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "currency": {
                                            "type": "string",
                                            "description": "ISO 4217, for example `EUR`."
                                        },
                                        "iban_name": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Account holder."
                                        },
                                        "iban": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "bic": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "iban_alt_name": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Account holder of the second bank account."
                                        },
                                        "iban_alt": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Second bank account."
                                        },
                                        "bic_alt": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "company_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Chamber of commerce number."
                                        },
                                        "registration_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "VAT number."
                                        },
                                        "custom_coordinates": {
                                            "type": "boolean",
                                            "nullable": true,
                                            "description": "The location on the map is set by hand."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings": {
            "get": {
                "tags": [
                    "Bookings"
                ],
                "summary": "List bookings between dates",
                "operationId": "bookingsList",
                "description": "Returns all bookings in the period for each roomtype in your account. To prevent heavy requests you need to give a `from` and `until` date; these may not be more than 36 days apart.",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-07-01"
                    },
                    {
                        "name": "until",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-07-31"
                    },
                    {
                        "name": "roomtype_id",
                        "in": "query",
                        "required": false,
                        "description": "Only return bookings of this roomtype.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "show_cancellations",
                        "in": "query",
                        "required": false,
                        "description": "Also return cancelled bookings.",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": 231920102956,
                                        "website_order_id": null,
                                        "state": "confirmed",
                                        "arrival": "2023-10-08",
                                        "departure": "2023-10-11",
                                        "expected_arrival_time": "19:00:00",
                                        "auto_send_email": true,
                                        "roomtype": {
                                            "id": "23192010281",
                                            "name": "Doubleroom with balcony",
                                            "placed_in_room": "Room 1"
                                        },
                                        "debtor_id": "23192010294",
                                        "debtor": {
                                            "id": "23192010294",
                                            "company_name": null,
                                            "company_chamber_id": null,
                                            "first_name": "Max",
                                            "last_name": "Musterman",
                                            "address": "Streetname 55 Block 3",
                                            "...": "..."
                                        },
                                        "number_of_guests": 2,
                                        "guests": [
                                            {
                                                "salutation": "male",
                                                "firstname": "Max",
                                                "lastname": "Musterman",
                                                "birthday": "1985-04-01",
                                                "address": "Demostreet 44",
                                                "zipcode": "123456",
                                                "city": "Amsterlin",
                                                "country": "NL",
                                                "phone": "0031 0800 0101",
                                                "email": "example@demohotel.com"
                                            },
                                            {
                                                "salutation": "female",
                                                "firstname": "Maxine",
                                                "...": "..."
                                            }
                                        ],
                                        "dietary_wishes": "No gluten",
                                        "access_code": "1234",
                                        "note": "Brings bicycles and would like to park them in the garage",
                                        "commission_amount": null,
                                        "rate": {
                                            "id": "23192010281",
                                            "name": "Default price rate"
                                        },
                                        "channel": {
                                            "id": "115TALSTRIPADVISORC1603970714",
                                            "label": "tripadvisor",
                                            "reference": "35e9bad0-3b889511e41a@rentals.tripadvisor.com",
                                            "info": "Booking imported from tripadvisor"
                                        },
                                        "forced_logies_price": 300,
                                        "invoice_enabled": true,
                                        "invoice": {
                                            "id": "P102006",
                                            "total_amount_incl_vat": 300,
                                            "total_amount_excl_vat": 240,
                                            "has_amount_to_pay": true
                                        },
                                        "breakfast_booked": true,
                                        "related_bookings": [
                                            {
                                                "id": 1210531312,
                                                "is_main_booking": true
                                            },
                                            {
                                                "id": 1210531313,
                                                "is_main_booking": false
                                            }
                                        ],
                                        "mybooking_url": "https://app.mytourist.cloud/mybooking/231920102956/...",
                                        "created_at": "2023-09-29 12:25:16",
                                        "updated_at": "2023-09-29 12:25:16",
                                        "checkin_at": "2023-10-08 14:35:51",
                                        "checkout_at": null
                                    },
                                    {
                                        "...": "..."
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "integer",
                                                "description": "Booking ID. Use it for the other booking endpoints."
                                            },
                                            "website_order_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Order ID when the booking was made in the booking engine."
                                            },
                                            "state": {
                                                "type": "string",
                                                "description": "`optional`, `confirmed` or `cancelled`."
                                            },
                                            "arrival": {
                                                "type": "string",
                                                "description": "`YYYY-MM-DD`."
                                            },
                                            "departure": {
                                                "type": "string",
                                                "description": "`YYYY-MM-DD`."
                                            },
                                            "expected_arrival_time": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "`HH:MM:SS`."
                                            },
                                            "auto_send_email": {
                                                "type": "boolean",
                                                "description": "The guest receives the automatic emails."
                                            },
                                            "roomtype": {
                                                "type": "object"
                                            },
                                            "debtor_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ID of the debtor."
                                            },
                                            "debtor": {
                                                "type": "object",
                                                "description": "The debtor, in the same format as Retrieve a debtor (without bookings and invoices)."
                                            },
                                            "number_of_guests": {
                                                "type": "integer"
                                            },
                                            "guests": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            },
                                            "dietary_wishes": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "access_code": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Access code of the room or building."
                                            },
                                            "note": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Internal note."
                                            },
                                            "commission_amount": {
                                                "type": "number",
                                                "nullable": true,
                                                "description": "Commission of the channel."
                                            },
                                            "rate": {
                                                "type": "object"
                                            },
                                            "channel": {
                                                "type": "object"
                                            },
                                            "forced_logies_price": {
                                                "type": "number",
                                                "description": "Forced logies price, or `false` when the price is calculated."
                                            },
                                            "invoice_enabled": {
                                                "type": "boolean",
                                                "description": "An invoice is made for this booking."
                                            },
                                            "invoice": {
                                                "type": "object",
                                                "description": "Main invoice: `id`, `total_amount_incl_vat`, `total_amount_excl_vat`, `has_amount_to_pay`. See Invoices."
                                            },
                                            "breakfast_booked": {
                                                "type": "boolean"
                                            },
                                            "related_bookings": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            },
                                            "mybooking_url": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Link to the booking page for the guest."
                                            },
                                            "created_at": {
                                                "type": "string",
                                                "description": "`YYYY-MM-DD HH:MM:SS`."
                                            },
                                            "updated_at": {
                                                "type": "string",
                                                "description": "`YYYY-MM-DD HH:MM:SS`."
                                            },
                                            "checkin_at": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Moment of check-in."
                                            },
                                            "checkout_at": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Moment of check-out."
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Create a booking",
                "operationId": "bookingsCreate",
                "description": "This endpoint expects that you have already checked the availability. It validates the availability of the roomtype once more, but checking it first with the availability endpoint is faster.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "channel": {
                                        "type": "string",
                                        "description": "Default `mytourist`. See available channels."
                                    },
                                    "arrival": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "departure": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "ID of a roomtype."
                                    },
                                    "rate_id": {
                                        "type": "string",
                                        "description": "ID of a price rate of the selected roomtype. Default: the first rate of the roomtype."
                                    },
                                    "unit_id": {
                                        "type": "string",
                                        "description": "Preferred room. When this room is not available, MyTourist picks another available room."
                                    },
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor. Default: no debtor attached."
                                    },
                                    "number_of_guests": {
                                        "type": "integer",
                                        "description": "Default `1`."
                                    },
                                    "number_of_children": {
                                        "type": "integer",
                                        "description": "Default `0`."
                                    },
                                    "state": {
                                        "type": "string",
                                        "description": "`optional` or `confirmed` (default)."
                                    },
                                    "auto_send_email": {
                                        "type": "boolean",
                                        "description": "Send the automatic emails to the guest. Default `true`."
                                    },
                                    "channel_reference": {
                                        "type": "string",
                                        "description": "Your own reference of the booking, for example the order number on your platform."
                                    },
                                    "dietary_wishes": {
                                        "type": "string"
                                    },
                                    "access_code": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string",
                                        "description": "Internal note."
                                    },
                                    "commission_amount": {
                                        "type": "number"
                                    },
                                    "forced_logies_price": {
                                        "type": "number",
                                        "description": "Force the logies price on the invoice."
                                    },
                                    "expected_arrival_time": {
                                        "type": "string",
                                        "description": "Per quarter of an hour from `10.00` up to `23.45`, or `23.59`."
                                    },
                                    "invoice_enabled": {
                                        "type": "boolean",
                                        "description": "Only on create. Create an invoice for this booking. Default `true`."
                                    },
                                    "checkin_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "checkout_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    }
                                },
                                "required": [
                                    "arrival",
                                    "departure",
                                    "roomtype_id"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "channel": {
                                        "type": "string",
                                        "description": "Default `mytourist`. See available channels."
                                    },
                                    "arrival": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "departure": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "ID of a roomtype."
                                    },
                                    "rate_id": {
                                        "type": "string",
                                        "description": "ID of a price rate of the selected roomtype. Default: the first rate of the roomtype."
                                    },
                                    "unit_id": {
                                        "type": "string",
                                        "description": "Preferred room. When this room is not available, MyTourist picks another available room."
                                    },
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor. Default: no debtor attached."
                                    },
                                    "number_of_guests": {
                                        "type": "integer",
                                        "description": "Default `1`."
                                    },
                                    "number_of_children": {
                                        "type": "integer",
                                        "description": "Default `0`."
                                    },
                                    "state": {
                                        "type": "string",
                                        "description": "`optional` or `confirmed` (default)."
                                    },
                                    "auto_send_email": {
                                        "type": "boolean",
                                        "description": "Send the automatic emails to the guest. Default `true`."
                                    },
                                    "channel_reference": {
                                        "type": "string",
                                        "description": "Your own reference of the booking, for example the order number on your platform."
                                    },
                                    "dietary_wishes": {
                                        "type": "string"
                                    },
                                    "access_code": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string",
                                        "description": "Internal note."
                                    },
                                    "commission_amount": {
                                        "type": "number"
                                    },
                                    "forced_logies_price": {
                                        "type": "number",
                                        "description": "Force the logies price on the invoice."
                                    },
                                    "expected_arrival_time": {
                                        "type": "string",
                                        "description": "Per quarter of an hour from `10.00` up to `23.45`, or `23.59`."
                                    },
                                    "invoice_enabled": {
                                        "type": "boolean",
                                        "description": "Only on create. Create an invoice for this booking. Default `true`."
                                    },
                                    "checkin_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "checkout_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    }
                                },
                                "required": [
                                    "arrival",
                                    "departure",
                                    "roomtype_id"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the created booking, in the same format as Retrieve a booking."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/from-debtor": {
            "get": {
                "tags": [
                    "Bookings"
                ],
                "summary": "List bookings of a debtor",
                "operationId": "bookingsFromDebtor",
                "description": "Like List bookings between dates, but for all bookings of one debtor.",
                "parameters": [
                    {
                        "name": "debtor_id",
                        "in": "query",
                        "required": true,
                        "description": "ID of the debtor.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "23192010294"
                    },
                    {
                        "name": "show_cancellations",
                        "in": "query",
                        "required": false,
                        "description": "Also return cancelled bookings.",
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Same format as List bookings between dates."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/current-bookings": {
            "get": {
                "tags": [
                    "Bookings"
                ],
                "summary": "List bookings currently staying",
                "operationId": "bookingsCurrent",
                "description": "Returns all bookings that arrive, stay or depart on the given date (default today). Like the insights page in MyTourist, the bookings are sorted by the order of the rooms and roomtypes.",
                "parameters": [
                    {
                        "name": "date",
                        "in": "query",
                        "required": false,
                        "description": "Format `YYYYMMDD`. Empty is today.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "20300701"
                    },
                    {
                        "name": "light",
                        "in": "query",
                        "required": false,
                        "description": "Faster response with less data. Default `false`.",
                        "schema": {
                            "type": "boolean"
                        },
                        "example": "true"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/{BOOKING_ID}": {
            "get": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Retrieve a booking",
                "operationId": "bookingsShow",
                "description": "Returns one booking with all information.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": 231920102956,
                                    "website_order_id": null,
                                    "state": "confirmed",
                                    "arrival": "2023-10-08",
                                    "departure": "2023-10-11",
                                    "expected_arrival_time": "19:00:00",
                                    "auto_send_email": true,
                                    "roomtype": {
                                        "id": "23192010281",
                                        "name": "Doubleroom with balcony",
                                        "placed_in_room": "Room 1"
                                    },
                                    "debtor_id": "23192010294",
                                    "debtor": {
                                        "id": "23192010294",
                                        "company_name": null,
                                        "company_chamber_id": null,
                                        "first_name": "Max",
                                        "last_name": "Musterman",
                                        "address": "Streetname 55 Block 3",
                                        "...": "..."
                                    },
                                    "number_of_guests": 2,
                                    "guests": [
                                        {
                                            "salutation": "male",
                                            "firstname": "Max",
                                            "lastname": "Musterman",
                                            "birthday": "1985-04-01",
                                            "address": "Demostreet 44",
                                            "zipcode": "123456",
                                            "city": "Amsterlin",
                                            "country": "NL",
                                            "phone": "0031 0800 0101",
                                            "email": "example@demohotel.com"
                                        },
                                        {
                                            "salutation": "female",
                                            "firstname": "Maxine",
                                            "...": "..."
                                        }
                                    ],
                                    "dietary_wishes": "No gluten",
                                    "access_code": "1234",
                                    "note": "Brings bicycles and would like to park them in the garage",
                                    "commission_amount": null,
                                    "rate": {
                                        "id": "23192010281",
                                        "name": "Default price rate"
                                    },
                                    "channel": {
                                        "id": "115TALSTRIPADVISORC1603970714",
                                        "label": "tripadvisor",
                                        "reference": "35e9bad0-3b889511e41a@rentals.tripadvisor.com",
                                        "info": "Booking imported from tripadvisor"
                                    },
                                    "forced_logies_price": 300,
                                    "invoice_enabled": true,
                                    "invoice": {
                                        "id": "P102006",
                                        "total_amount_incl_vat": 300,
                                        "total_amount_excl_vat": 240,
                                        "has_amount_to_pay": true
                                    },
                                    "breakfast_booked": true,
                                    "related_bookings": [
                                        {
                                            "id": 1210531312,
                                            "is_main_booking": true
                                        },
                                        {
                                            "id": 1210531313,
                                            "is_main_booking": false
                                        }
                                    ],
                                    "mybooking_url": "https://app.mytourist.cloud/mybooking/231920102956/...",
                                    "created_at": "2023-09-29 12:25:16",
                                    "updated_at": "2023-09-29 12:25:16",
                                    "checkin_at": "2023-10-08 14:35:51",
                                    "checkout_at": null
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "integer",
                                            "description": "Booking ID. Use it for the other booking endpoints."
                                        },
                                        "website_order_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Order ID when the booking was made in the booking engine."
                                        },
                                        "state": {
                                            "type": "string",
                                            "description": "`optional`, `confirmed` or `cancelled`."
                                        },
                                        "arrival": {
                                            "type": "string",
                                            "description": "`YYYY-MM-DD`."
                                        },
                                        "departure": {
                                            "type": "string",
                                            "description": "`YYYY-MM-DD`."
                                        },
                                        "expected_arrival_time": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "`HH:MM:SS`."
                                        },
                                        "auto_send_email": {
                                            "type": "boolean",
                                            "description": "The guest receives the automatic emails."
                                        },
                                        "roomtype": {
                                            "type": "object"
                                        },
                                        "debtor_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the debtor."
                                        },
                                        "debtor": {
                                            "type": "object",
                                            "description": "The debtor, in the same format as Retrieve a debtor (without bookings and invoices)."
                                        },
                                        "number_of_guests": {
                                            "type": "integer"
                                        },
                                        "guests": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        },
                                        "dietary_wishes": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "access_code": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Access code of the room or building."
                                        },
                                        "note": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Internal note."
                                        },
                                        "commission_amount": {
                                            "type": "number",
                                            "nullable": true,
                                            "description": "Commission of the channel."
                                        },
                                        "rate": {
                                            "type": "object"
                                        },
                                        "channel": {
                                            "type": "object"
                                        },
                                        "forced_logies_price": {
                                            "type": "number",
                                            "description": "Forced logies price, or `false` when the price is calculated."
                                        },
                                        "invoice_enabled": {
                                            "type": "boolean",
                                            "description": "An invoice is made for this booking."
                                        },
                                        "invoice": {
                                            "type": "object",
                                            "description": "Main invoice: `id`, `total_amount_incl_vat`, `total_amount_excl_vat`, `has_amount_to_pay`. See Invoices."
                                        },
                                        "breakfast_booked": {
                                            "type": "boolean"
                                        },
                                        "related_bookings": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        },
                                        "mybooking_url": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Link to the booking page for the guest."
                                        },
                                        "created_at": {
                                            "type": "string",
                                            "description": "`YYYY-MM-DD HH:MM:SS`."
                                        },
                                        "updated_at": {
                                            "type": "string",
                                            "description": "`YYYY-MM-DD HH:MM:SS`."
                                        },
                                        "checkin_at": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Moment of check-in."
                                        },
                                        "checkout_at": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Moment of check-out."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Update a booking",
                "operationId": "bookingsUpdate",
                "description": "Send the changed JSON or only the fields you want to change. A field you leave out is ignored; a field you send empty is reset to its default or `null`.\n\n- Bookings from connected channels are partly locked for synchronization: `arrival`, `departure`, `channel` and `channel_reference` are not accepted.\n- When you change the roomtype, change the price rate as well. Without a `rate_id` we take the default price rate of the new roomtype.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "channel": {
                                        "type": "string",
                                        "description": "Default `mytourist`. See available channels."
                                    },
                                    "arrival": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "departure": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "ID of a roomtype."
                                    },
                                    "rate_id": {
                                        "type": "string",
                                        "description": "ID of a price rate of the selected roomtype. Default: the first rate of the roomtype."
                                    },
                                    "unit_id": {
                                        "type": "string",
                                        "description": "Preferred room. When this room is not available, MyTourist picks another available room."
                                    },
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor. Default: no debtor attached."
                                    },
                                    "number_of_guests": {
                                        "type": "integer",
                                        "description": "Default `1`."
                                    },
                                    "number_of_children": {
                                        "type": "integer",
                                        "description": "Default `0`."
                                    },
                                    "state": {
                                        "type": "string",
                                        "description": "`optional` or `confirmed` (default)."
                                    },
                                    "auto_send_email": {
                                        "type": "boolean",
                                        "description": "Send the automatic emails to the guest. Default `true`."
                                    },
                                    "channel_reference": {
                                        "type": "string",
                                        "description": "Your own reference of the booking, for example the order number on your platform."
                                    },
                                    "dietary_wishes": {
                                        "type": "string"
                                    },
                                    "access_code": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string",
                                        "description": "Internal note."
                                    },
                                    "commission_amount": {
                                        "type": "number"
                                    },
                                    "forced_logies_price": {
                                        "type": "number",
                                        "description": "Force the logies price on the invoice."
                                    },
                                    "expected_arrival_time": {
                                        "type": "string",
                                        "description": "Per quarter of an hour from `10.00` up to `23.45`, or `23.59`."
                                    },
                                    "invoice_enabled": {
                                        "type": "boolean",
                                        "description": "Only on create. Create an invoice for this booking. Default `true`."
                                    },
                                    "checkin_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "checkout_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "recalculate_invoice_logies": {
                                        "type": "boolean",
                                        "description": "Send `true` to recalculate the logies lines on the invoice."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "channel": {
                                        "type": "string",
                                        "description": "Default `mytourist`. See available channels."
                                    },
                                    "arrival": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "departure": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "ID of a roomtype."
                                    },
                                    "rate_id": {
                                        "type": "string",
                                        "description": "ID of a price rate of the selected roomtype. Default: the first rate of the roomtype."
                                    },
                                    "unit_id": {
                                        "type": "string",
                                        "description": "Preferred room. When this room is not available, MyTourist picks another available room."
                                    },
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor. Default: no debtor attached."
                                    },
                                    "number_of_guests": {
                                        "type": "integer",
                                        "description": "Default `1`."
                                    },
                                    "number_of_children": {
                                        "type": "integer",
                                        "description": "Default `0`."
                                    },
                                    "state": {
                                        "type": "string",
                                        "description": "`optional` or `confirmed` (default)."
                                    },
                                    "auto_send_email": {
                                        "type": "boolean",
                                        "description": "Send the automatic emails to the guest. Default `true`."
                                    },
                                    "channel_reference": {
                                        "type": "string",
                                        "description": "Your own reference of the booking, for example the order number on your platform."
                                    },
                                    "dietary_wishes": {
                                        "type": "string"
                                    },
                                    "access_code": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string",
                                        "description": "Internal note."
                                    },
                                    "commission_amount": {
                                        "type": "number"
                                    },
                                    "forced_logies_price": {
                                        "type": "number",
                                        "description": "Force the logies price on the invoice."
                                    },
                                    "expected_arrival_time": {
                                        "type": "string",
                                        "description": "Per quarter of an hour from `10.00` up to `23.45`, or `23.59`."
                                    },
                                    "invoice_enabled": {
                                        "type": "boolean",
                                        "description": "Only on create. Create an invoice for this booking. Default `true`."
                                    },
                                    "checkin_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "checkout_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "recalculate_invoice_logies": {
                                        "type": "boolean",
                                        "description": "Send `true` to recalculate the logies lines on the invoice."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the updated booking."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Cancel a booking",
                "operationId": "bookingsCancel",
                "description": "Only bookings from `mytourist`, `website` (booking engine) or `api` can be cancelled via the API. Bookings with a live connection to an external platform cannot be cancelled here. If a booking is out of sync, please contact support.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/{BOOKING_ID}/attach": {
            "post": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Attach to a booking",
                "operationId": "bookingsAttach",
                "description": "Attach this booking to a main booking. MyTourist then merges both invoices. Only bookings from `mytourist`, `website` or `api` can be attached.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "main_reservation": {
                                        "type": "integer",
                                        "description": "ID of the main booking."
                                    }
                                },
                                "required": [
                                    "main_reservation"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "main_reservation": {
                                        "type": "integer",
                                        "description": "ID of the main booking."
                                    }
                                },
                                "required": [
                                    "main_reservation"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/{BOOKING_ID}/detach": {
            "post": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Detach from a booking",
                "operationId": "bookingsDetach",
                "description": "Detach this booking from its main booking. MyTourist creates a new invoice for the detached booking. Only bookings from `mytourist`, `website` or `api` can be detached.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/{BOOKING_ID}/guests": {
            "get": {
                "tags": [
                    "Bookings"
                ],
                "summary": "List guests",
                "operationId": "bookingsGuests",
                "description": "Returns all guests of one booking.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "guest_id": 1,
                                        "salutation": "male",
                                        "firstname": "Max",
                                        "lastname": "Musterman",
                                        "birthday": "1962-07-03",
                                        "address": "Previewstreet 44",
                                        "zipcode": "1234AA",
                                        "city": "Amsterdam",
                                        "country": "NL",
                                        "phone": "06123456789",
                                        "email": "email@email.com"
                                    },
                                    {
                                        "guest_id": 2,
                                        "...": "..."
                                    }
                                ]
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/bookings/{BOOKING_ID}/guests/{GUEST_ID}": {
            "post": {
                "tags": [
                    "Bookings"
                ],
                "summary": "Update a guest",
                "operationId": "bookingsGuestUpdate",
                "description": "Update one guest of a booking. Use the `guest_id` from List guests.",
                "parameters": [
                    {
                        "name": "BOOKING_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "GUEST_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "salutation": {
                                        "type": "string",
                                        "description": "`male` or `female`."
                                    },
                                    "firstname": {
                                        "type": "string"
                                    },
                                    "lastname": {
                                        "type": "string"
                                    },
                                    "birthday": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`."
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "salutation": {
                                        "type": "string",
                                        "description": "`male` or `female`."
                                    },
                                    "firstname": {
                                        "type": "string"
                                    },
                                    "lastname": {
                                        "type": "string"
                                    },
                                    "birthday": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`."
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/availability": {
            "get": {
                "tags": [
                    "Availability"
                ],
                "summary": "Check availability",
                "operationId": "availabilityCheck",
                "description": "Checks the availability of one or all roomtypes in a date range. The API always returns the number of available rooms per roomtype, some information about the roomtype (so you need fewer calls to the roomtypes endpoint) and its price rates.\n\nNeed the availability and price per day, for example for a calendar? Use Fetch the calendar data instead.",
                "parameters": [
                    {
                        "name": "arrival",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-07-01"
                    },
                    {
                        "name": "departure",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-07-04"
                    },
                    {
                        "name": "roomtype_id",
                        "in": "query",
                        "required": false,
                        "description": "Only return this roomtype.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "language",
                        "in": "query",
                        "required": false,
                        "description": "ISO 639-1, for example `en`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "81912063",
                                        "rooms_available": 1,
                                        "name": "Doubleroom Deluxe with balcony",
                                        "description": "Our best room with an amazing view over the city!",
                                        "rates": [
                                            {
                                                "id": 66118004,
                                                "rate_available": true,
                                                "total_price": 200,
                                                "name": "Conform arrangement",
                                                "reasons": []
                                            },
                                            {
                                                "id": 82010274,
                                                "rate_available": false,
                                                "total_price": 0,
                                                "name": "Bubbles arrangement - Long weekend",
                                                "reasons": [
                                                    "closedonarrival",
                                                    "minstay"
                                                ]
                                            }
                                        ]
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "ID of the roomtype."
                                            },
                                            "rooms_available": {
                                                "type": "integer",
                                                "description": "Live number of available rooms in this roomtype."
                                            },
                                            "name": {
                                                "type": "string",
                                                "description": "Name of the roomtype."
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "rates": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/calendar": {
            "post": {
                "tags": [
                    "Calendar"
                ],
                "summary": "Fetch the calendar data",
                "operationId": "calendarFetch",
                "description": "Returns the number of available rooms and the current logies price per price rate for each day of the month of the given date. You can fetch all roomtypes or a single one.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "date": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. The month of this date is returned."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "Only return this roomtype."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1, for example `en`."
                                    }
                                },
                                "required": [
                                    "date"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "date": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. The month of this date is returned."
                                    },
                                    "roomtype_id": {
                                        "type": "string",
                                        "description": "Only return this roomtype."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1, for example `en`."
                                    }
                                },
                                "required": [
                                    "date"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "The result is grouped by roomtype ID, then by date (`YYYYMMDD`), then by price rate ID.",
                        "content": {
                            "application/json": {
                                "example": {
                                    "4719120611": {
                                        "20301130": {
                                            "availability": {
                                                "value": 2,
                                                "custom_value": false
                                            },
                                            "prices": {
                                                "120022112": {
                                                    "id": "120022112",
                                                    "min_stay": 2,
                                                    "max_stay": 3,
                                                    "closed_on_arrival": false,
                                                    "closed_on_departure": true,
                                                    "name": "Weekend arrangement",
                                                    "public_name": "Stay with 15% discount - from 3 nights",
                                                    "current_price": 100,
                                                    "default_price": 100,
                                                    "is_custom_price": false
                                                },
                                                "120022113": {
                                                    "id": "120022113",
                                                    "min_stay": 3,
                                                    "max_stay": 14,
                                                    "closed_on_arrival": false,
                                                    "closed_on_departure": true,
                                                    "name": "OTA (booking.com)",
                                                    "public_name": "",
                                                    "current_price": 110,
                                                    "default_price": 110,
                                                    "is_custom_price": false,
                                                    "is_subrate": true,
                                                    "subrate": {
                                                        "adjusted_by": "percentage",
                                                        "value": "10"
                                                    }
                                                }
                                            }
                                        },
                                        "20301201": {
                                            "...": "..."
                                        }
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "availability": {
                                            "type": "object"
                                        },
                                        "prices": {
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/calendar/{RATE_ID}": {
            "post": {
                "tags": [
                    "Calendar"
                ],
                "summary": "Bulk changes",
                "operationId": "calendarBulk",
                "description": "Change the availability, price and restrictions of one price rate for one day or a period. With this endpoint you no longer need to make bulk changes in the MyTourist calendar by hand. The `until` date may be at most 2 years ahead.",
                "parameters": [
                    {
                        "name": "RATE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "rooms_to_sell": {
                                        "type": "integer",
                                        "description": "Rooms to sell; never higher than the actual number of rooms. Bookings are subtracted automatically. Use `auto` for the default."
                                    },
                                    "min_stay": {
                                        "type": "integer",
                                        "description": "Nights, or `auto` for the default of the price rate."
                                    },
                                    "max_stay": {
                                        "type": "integer",
                                        "description": "Nights, or `auto` for the default of the price rate."
                                    },
                                    "close_to_arrival": {
                                        "type": "string",
                                        "description": "`closed` or `open`, or `default` to reset to the price rate settings."
                                    },
                                    "close_to_departure": {
                                        "type": "string",
                                        "description": "`closed` or `open`, or `default` to reset to the price rate settings."
                                    },
                                    "price_per_night": {
                                        "type": "number",
                                        "description": "Price per night, or `auto` for the default price."
                                    }
                                },
                                "required": [
                                    "from",
                                    "until"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`."
                                    },
                                    "rooms_to_sell": {
                                        "type": "integer",
                                        "description": "Rooms to sell; never higher than the actual number of rooms. Bookings are subtracted automatically. Use `auto` for the default."
                                    },
                                    "min_stay": {
                                        "type": "integer",
                                        "description": "Nights, or `auto` for the default of the price rate."
                                    },
                                    "max_stay": {
                                        "type": "integer",
                                        "description": "Nights, or `auto` for the default of the price rate."
                                    },
                                    "close_to_arrival": {
                                        "type": "string",
                                        "description": "`closed` or `open`, or `default` to reset to the price rate settings."
                                    },
                                    "close_to_departure": {
                                        "type": "string",
                                        "description": "`closed` or `open`, or `default` to reset to the price rate settings."
                                    },
                                    "price_per_night": {
                                        "type": "number",
                                        "description": "Price per night, or `auto` for the default price."
                                    }
                                },
                                "required": [
                                    "from",
                                    "until"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/calendar/bulk": {
            "post": {
                "tags": [
                    "Calendar"
                ],
                "summary": "Multiple bulk changes in one request",
                "operationId": "calendarBulkMultiple",
                "description": "Post a JSON array to push several bulk changes in one call. Each item takes the same fields as Bulk changes, plus the `rate_id`.",
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "array",
                                "items": {
                                    "type": "object"
                                }
                            },
                            "example": [
                                {
                                    "rate_id": "12345678",
                                    "from": "2030-08-14",
                                    "until": "2030-08-14",
                                    "price_per_night": "55",
                                    "min_stay": 3
                                },
                                {
                                    "rate_id": "87654321",
                                    "from": "2030-08-15",
                                    "until": "2030-08-17",
                                    "price_per_night": "60",
                                    "min_stay": 2
                                }
                            ]
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/debtors": {
            "get": {
                "tags": [
                    "Debtors"
                ],
                "summary": "List all debtors",
                "operationId": "debtorsList",
                "description": "Returns all your debtors, newest first.\n\n**Search debtors:** Returns the debtors that match **all** given search terms. Searched fields: first name, last name, company name, company ID, email, phone, street, city, zipcode and debtor ID.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192010299",
                                        "company_name": null,
                                        "company_chamber_id": null,
                                        "first_name": "Max",
                                        "last_name": "Musterman",
                                        "address": "Streetname 55 Block 3",
                                        "zipcode": "1234AB",
                                        "city": "Amsterdam",
                                        "country": "NL",
                                        "email": "max@example.com",
                                        "mobile": "0612345678",
                                        "phone": null,
                                        "vat_id": null,
                                        "note": null,
                                        "bank_account": null,
                                        "latitude": "27.606888",
                                        "longitude": "-42.670898"
                                    },
                                    {
                                        "...": "..."
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Debtor ID. Use it for the other debtor endpoints and as `debtor_id` in bookings and invoices."
                                            },
                                            "company_name": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "company_chamber_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Chamber of commerce number (KVK)."
                                            },
                                            "first_name": {
                                                "type": "string"
                                            },
                                            "last_name": {
                                                "type": "string"
                                            },
                                            "address": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Street and house number."
                                            },
                                            "zipcode": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "city": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "country": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ISO 3166-1 alpha-2."
                                            },
                                            "email": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "mobile": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "phone": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "vat_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "VAT number."
                                            },
                                            "note": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "bank_account": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "latitude": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "longitude": {
                                                "type": "string",
                                                "nullable": true
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                },
                "parameters": [
                    {
                        "name": "search",
                        "in": "query",
                        "required": false,
                        "description": "One or more search terms, separated by commas.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "musterman,amsterdam"
                    }
                ]
            },
            "post": {
                "tags": [
                    "Debtors"
                ],
                "summary": "Create a debtor",
                "operationId": "debtorsCreate",
                "description": "Creates a debtor and returns it.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "first_name": {
                                        "type": "string"
                                    },
                                    "last_name": {
                                        "type": "string"
                                    },
                                    "company_name": {
                                        "type": "string"
                                    },
                                    "company_chamber_id": {
                                        "type": "string",
                                        "description": "Chamber of commerce number (KVK)."
                                    },
                                    "vat_id": {
                                        "type": "string"
                                    },
                                    "bank_account": {
                                        "type": "string"
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "mobile": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    },
                                    "latitude": {
                                        "type": "number",
                                        "description": "For example `27.606888`."
                                    },
                                    "longitude": {
                                        "type": "number",
                                        "description": "For example `-42.670898`."
                                    }
                                },
                                "required": [
                                    "first_name",
                                    "last_name"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "first_name": {
                                        "type": "string"
                                    },
                                    "last_name": {
                                        "type": "string"
                                    },
                                    "company_name": {
                                        "type": "string"
                                    },
                                    "company_chamber_id": {
                                        "type": "string",
                                        "description": "Chamber of commerce number (KVK)."
                                    },
                                    "vat_id": {
                                        "type": "string"
                                    },
                                    "bank_account": {
                                        "type": "string"
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "mobile": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    },
                                    "latitude": {
                                        "type": "number",
                                        "description": "For example `27.606888`."
                                    },
                                    "longitude": {
                                        "type": "number",
                                        "description": "For example `-42.670898`."
                                    }
                                },
                                "required": [
                                    "first_name",
                                    "last_name"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the saved debtor, in the same format as Retrieve a debtor."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/debtors/{DEBTOR_ID}": {
            "get": {
                "tags": [
                    "Debtors"
                ],
                "summary": "Retrieve a debtor",
                "operationId": "debtorsShow",
                "description": "Returns one debtor, including all bookings and invoices of this debtor.",
                "parameters": [
                    {
                        "name": "DEBTOR_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192010299",
                                    "company_name": null,
                                    "company_chamber_id": null,
                                    "first_name": "Max",
                                    "last_name": "Musterman",
                                    "address": "Streetname 55 Block 3",
                                    "zipcode": "1234AB",
                                    "city": "Amsterdam",
                                    "country": "NL",
                                    "email": "max@example.com",
                                    "mobile": "0612345678",
                                    "phone": null,
                                    "vat_id": null,
                                    "note": null,
                                    "bank_account": null,
                                    "latitude": "27.606888",
                                    "longitude": "-42.670898",
                                    "bookings": [
                                        {
                                            "id": 231920102956,
                                            "state": "archived",
                                            "arrival": "20201008",
                                            "departure": "20201011"
                                        }
                                    ],
                                    "invoices": [
                                        {
                                            "id": "P1120078",
                                            "state": "open",
                                            "type": "proforma"
                                        }
                                    ]
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Debtor ID. Use it for the other debtor endpoints and as `debtor_id` in bookings and invoices."
                                        },
                                        "company_name": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "company_chamber_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Chamber of commerce number (KVK)."
                                        },
                                        "first_name": {
                                            "type": "string"
                                        },
                                        "last_name": {
                                            "type": "string"
                                        },
                                        "address": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Street and house number."
                                        },
                                        "zipcode": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "city": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "country": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ISO 3166-1 alpha-2."
                                        },
                                        "email": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "mobile": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "phone": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "vat_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "VAT number."
                                        },
                                        "note": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "bank_account": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "latitude": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "longitude": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "bookings": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        },
                                        "invoices": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Debtors"
                ],
                "summary": "Update a debtor",
                "operationId": "debtorsUpdate",
                "description": "Send the full JSON or only the fields you want to change. A field you send is always overwritten; a field you leave out keeps its current value.",
                "parameters": [
                    {
                        "name": "DEBTOR_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "first_name": {
                                        "type": "string"
                                    },
                                    "last_name": {
                                        "type": "string"
                                    },
                                    "company_name": {
                                        "type": "string"
                                    },
                                    "company_chamber_id": {
                                        "type": "string",
                                        "description": "Chamber of commerce number (KVK)."
                                    },
                                    "vat_id": {
                                        "type": "string"
                                    },
                                    "bank_account": {
                                        "type": "string"
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "mobile": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    },
                                    "latitude": {
                                        "type": "number",
                                        "description": "For example `27.606888`."
                                    },
                                    "longitude": {
                                        "type": "number",
                                        "description": "For example `-42.670898`."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "first_name": {
                                        "type": "string"
                                    },
                                    "last_name": {
                                        "type": "string"
                                    },
                                    "company_name": {
                                        "type": "string"
                                    },
                                    "company_chamber_id": {
                                        "type": "string",
                                        "description": "Chamber of commerce number (KVK)."
                                    },
                                    "vat_id": {
                                        "type": "string"
                                    },
                                    "bank_account": {
                                        "type": "string"
                                    },
                                    "address": {
                                        "type": "string"
                                    },
                                    "zipcode": {
                                        "type": "string"
                                    },
                                    "city": {
                                        "type": "string"
                                    },
                                    "country": {
                                        "type": "string",
                                        "description": "ISO 3166-1 alpha-2, for example `NL`."
                                    },
                                    "mobile": {
                                        "type": "string"
                                    },
                                    "phone": {
                                        "type": "string"
                                    },
                                    "email": {
                                        "type": "string"
                                    },
                                    "note": {
                                        "type": "string"
                                    },
                                    "latitude": {
                                        "type": "number",
                                        "description": "For example `27.606888`."
                                    },
                                    "longitude": {
                                        "type": "number",
                                        "description": "For example `-42.670898`."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the saved debtor."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Debtors"
                ],
                "summary": "Delete a debtor",
                "operationId": "debtorsDelete",
                "description": "Deletes the debtor. Returns `success`, or HTTP `400` when the debtor does not exist.",
                "parameters": [
                    {
                        "name": "DEBTOR_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices": {
            "get": {
                "tags": [
                    "Invoices"
                ],
                "summary": "List invoices",
                "operationId": "invoicesList",
                "description": "Returns all invoices with an invoice date in the period. To prevent heavy server load, `from` and `until` are required and may be at most 36 days apart.",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-11-01"
                    },
                    {
                        "name": "until",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-11-30"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "P1020077",
                                        "invoiced_at": "20301104",
                                        "invoice_id": null,
                                        "language": "en",
                                        "type": "proforma",
                                        "reservation": "1240815785",
                                        "financial_state": "open",
                                        "debtor_id": "23192010282",
                                        "footnote": "",
                                        "reference": "PO-12345",
                                        "product_lines": [
                                            {
                                                "id": "2319201102165",
                                                "type": "logies",
                                                "number": 1,
                                                "description": "Doubleroom with balcony - 7 night(s) - 2 guest(s)",
                                                "price_incl_vat": "560.00",
                                                "price_excl_vat": "504.50",
                                                "tax_amount": "55.50",
                                                "tax_rate": "11.00",
                                                "tax_type": "standard",
                                                "product_id": null
                                            },
                                            {
                                                "id": "2319201102164",
                                                "type": "product",
                                                "number": 8,
                                                "description": "Bottle of red wine",
                                                "price_incl_vat": "352.00",
                                                "price_excl_vat": "317.12",
                                                "tax_amount": "34.88",
                                                "tax_rate": "11.00",
                                                "tax_type": "standard",
                                                "product_id": null
                                            }
                                        ],
                                        "tourist_tax": {
                                            "amount": "0.00",
                                            "based_on_guests": 0,
                                            "outdated": false
                                        },
                                        "vat_lines": {
                                            "11": 90.38
                                        },
                                        "payments": [
                                            {
                                                "id": "23192011021",
                                                "payment_method": "bank_card",
                                                "amount": "10.00",
                                                "description": "",
                                                "created_at": "2030-11-04 10:12:00"
                                            }
                                        ],
                                        "financial": {
                                            "has_amount_to_pay": true,
                                            "custom_logies_price": false,
                                            "deposit_amount": "112.00",
                                            "deposit_open_to_pay": 102,
                                            "total_amount_incl_vat": 912,
                                            "total_amount_excl_vat": 821.62,
                                            "total_paid": 10
                                        }
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Invoice ID, for example `P1020077`. Use it for the other invoice endpoints."
                                            },
                                            "invoiced_at": {
                                                "type": "string",
                                                "description": "Invoice date, `YYYYMMDD`."
                                            },
                                            "invoice_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Invoice number from your administration; `null` while the invoice is a proforma."
                                            },
                                            "language": {
                                                "type": "string",
                                                "description": "Language of the invoice."
                                            },
                                            "type": {
                                                "type": "string",
                                                "description": "`proforma`, `invoice` or `creditinvoice`. See the table."
                                            },
                                            "reservation": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ID of the booking, or `null` for a single invoice."
                                            },
                                            "financial_state": {
                                                "type": "string",
                                                "description": "`concept`, `open`, `payed` or `credited`. See the table."
                                            },
                                            "debtor_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ID of the debtor."
                                            },
                                            "footnote": {
                                                "type": "string",
                                                "description": "Text at the bottom of the invoice."
                                            },
                                            "reference": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Reference of the customer, for example an order or PO number."
                                            },
                                            "product_lines": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            },
                                            "tourist_tax": {
                                                "type": "object",
                                                "description": "Only for booking invoices: `amount`, `based_on_guests` and `outdated`."
                                            },
                                            "vat_lines": {
                                                "type": "object",
                                                "description": "VAT amount per rate: `{ \"21\": 12.50 }`. Lines without VAT (`tax_type` `exempt`) are under the key `exempt`, always with amount `0`: `{ \"21\": 12.50, \"exempt\": 0 }`."
                                            },
                                            "payments": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            },
                                            "financial": {
                                                "type": "object"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Create an invoice",
                "operationId": "invoicesCreate",
                "description": "Creates a single invoice without a booking. It works exactly like a booking invoice, except that the automatic price calculation (price rates and tourist tax) is not active. A new invoice is always a `proforma`.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor."
                                    },
                                    "lang": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `en` or `fr`. Default: the invoice language of your account."
                                    },
                                    "invoiced_at": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`. Is set again when you make the invoice final."
                                    },
                                    "footnote": {
                                        "type": "string",
                                        "description": "Default: the footnote of your account."
                                    },
                                    "reference": {
                                        "type": "string",
                                        "description": "Reference (for example the order or PO number of the customer), shown on the invoice. Max. 255 characters; send it empty to clear it."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor."
                                    },
                                    "lang": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `en` or `fr`. Default: the invoice language of your account."
                                    },
                                    "invoiced_at": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`. Is set again when you make the invoice final."
                                    },
                                    "footnote": {
                                        "type": "string",
                                        "description": "Default: the footnote of your account."
                                    },
                                    "reference": {
                                        "type": "string",
                                        "description": "Reference (for example the order or PO number of the customer), shown on the invoice. Max. 255 characters; send it empty to clear it."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the created invoice, in the same format as Retrieve an invoice."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}": {
            "get": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Retrieve an invoice",
                "operationId": "invoicesShow",
                "description": "Returns one invoice. Use the `id` of the invoice (for example `P1020077`).",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "P1020077",
                                    "invoiced_at": "20301104",
                                    "invoice_id": null,
                                    "language": "en",
                                    "type": "proforma",
                                    "reservation": "1240815785",
                                    "financial_state": "open",
                                    "debtor_id": "23192010282",
                                    "footnote": "",
                                    "reference": "PO-12345",
                                    "product_lines": [
                                        {
                                            "id": "2319201102165",
                                            "type": "logies",
                                            "number": 1,
                                            "description": "Doubleroom with balcony - 7 night(s) - 2 guest(s)",
                                            "price_incl_vat": "560.00",
                                            "price_excl_vat": "504.50",
                                            "tax_amount": "55.50",
                                            "tax_rate": "11.00",
                                            "tax_type": "standard",
                                            "product_id": null
                                        },
                                        {
                                            "id": "2319201102164",
                                            "type": "product",
                                            "number": 8,
                                            "description": "Bottle of red wine",
                                            "price_incl_vat": "352.00",
                                            "price_excl_vat": "317.12",
                                            "tax_amount": "34.88",
                                            "tax_rate": "11.00",
                                            "tax_type": "standard",
                                            "product_id": null
                                        }
                                    ],
                                    "tourist_tax": {
                                        "amount": "0.00",
                                        "based_on_guests": 0,
                                        "outdated": false
                                    },
                                    "vat_lines": {
                                        "11": 90.38
                                    },
                                    "payments": [
                                        {
                                            "id": "23192011021",
                                            "payment_method": "bank_card",
                                            "amount": "10.00",
                                            "description": "",
                                            "created_at": "2030-11-04 10:12:00"
                                        }
                                    ],
                                    "financial": {
                                        "has_amount_to_pay": true,
                                        "custom_logies_price": false,
                                        "deposit_amount": "112.00",
                                        "deposit_open_to_pay": 102,
                                        "total_amount_incl_vat": 912,
                                        "total_amount_excl_vat": 821.62,
                                        "total_paid": 10
                                    }
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Invoice ID, for example `P1020077`. Use it for the other invoice endpoints."
                                        },
                                        "invoiced_at": {
                                            "type": "string",
                                            "description": "Invoice date, `YYYYMMDD`."
                                        },
                                        "invoice_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Invoice number from your administration; `null` while the invoice is a proforma."
                                        },
                                        "language": {
                                            "type": "string",
                                            "description": "Language of the invoice."
                                        },
                                        "type": {
                                            "type": "string",
                                            "description": "`proforma`, `invoice` or `creditinvoice`. See the table."
                                        },
                                        "reservation": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the booking, or `null` for a single invoice."
                                        },
                                        "financial_state": {
                                            "type": "string",
                                            "description": "`concept`, `open`, `payed` or `credited`. See the table."
                                        },
                                        "debtor_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the debtor."
                                        },
                                        "footnote": {
                                            "type": "string",
                                            "description": "Text at the bottom of the invoice."
                                        },
                                        "reference": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Reference of the customer, for example an order or PO number."
                                        },
                                        "product_lines": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        },
                                        "tourist_tax": {
                                            "type": "object",
                                            "description": "Only for booking invoices: `amount`, `based_on_guests` and `outdated`."
                                        },
                                        "vat_lines": {
                                            "type": "object",
                                            "description": "VAT amount per rate: `{ \"21\": 12.50 }`. Lines without VAT (`tax_type` `exempt`) are under the key `exempt`, always with amount `0`: `{ \"21\": 12.50, \"exempt\": 0 }`."
                                        },
                                        "payments": {
                                            "type": "array",
                                            "items": {
                                                "type": "object"
                                            }
                                        },
                                        "financial": {
                                            "type": "object"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Update an invoice",
                "operationId": "invoicesUpdate",
                "description": "Changes only the fields you send.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor."
                                    },
                                    "lang": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `en` or `fr`. Default: the invoice language of your account."
                                    },
                                    "invoiced_at": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`. Is set again when you make the invoice final."
                                    },
                                    "footnote": {
                                        "type": "string",
                                        "description": "Default: the footnote of your account."
                                    },
                                    "reference": {
                                        "type": "string",
                                        "description": "Reference (for example the order or PO number of the customer), shown on the invoice. Max. 255 characters; send it empty to clear it."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "debtor_id": {
                                        "type": "string",
                                        "description": "ID of a debtor."
                                    },
                                    "lang": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `en` or `fr`. Default: the invoice language of your account."
                                    },
                                    "invoiced_at": {
                                        "type": "string",
                                        "description": "Format `YYYYMMDD`. Is set again when you make the invoice final."
                                    },
                                    "footnote": {
                                        "type": "string",
                                        "description": "Default: the footnote of your account."
                                    },
                                    "reference": {
                                        "type": "string",
                                        "description": "Reference (for example the order or PO number of the customer), shown on the invoice. Max. 255 characters; send it empty to clear it."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the updated invoice."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Delete a proforma invoice",
                "operationId": "invoicesDelete",
                "description": "Removes a proforma invoice. Final invoices cannot be removed (HTTP `400`).",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/make-final/{INVOICE_ID}": {
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Make an invoice final",
                "operationId": "invoicesMakeFinal",
                "description": "Gives the proforma invoice the next invoice number from your administration and changes its type to `invoice`. A final invoice can no longer be removed; it can only be credited.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "invoice_date": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Default: today."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "invoice_date": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Default: today."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the final invoice."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/credit": {
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Credit an invoice",
                "operationId": "invoicesCredit",
                "description": "Creates a credit invoice for a final invoice: a copy with the same lines, all with negative amounts. This is the same as the button \"Credit\" in MyTourist. The credit invoice starts as a `proforma`, so you can still check it; make it final with its `id`. Only final invoices can be credited (HTTP `400` for a proforma).",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Returns the new credit invoice, in the same format as Retrieve an invoice."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/lines": {
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Add a product line",
                "operationId": "invoicesLineAdd",
                "description": "Add a product from MyTourist, or your own line with a description and price. When you add the same product again, its number is increased.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "number": {
                                        "type": "integer",
                                        "description": "Number of items."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "Is replaced by the product name when you send a `product_id`."
                                    },
                                    "price_incl": {
                                        "type": "number",
                                        "description": "Price per item incl. VAT. Needed when you do not send a `product_id`."
                                    },
                                    "product_id": {
                                        "type": "string",
                                        "description": "ID of a product. The product name and tax rate are used."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate. Only without a `product_id`."
                                    },
                                    "information": {
                                        "type": "string",
                                        "description": "Extra information on the line."
                                    }
                                },
                                "required": [
                                    "number",
                                    "description"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "number": {
                                        "type": "integer",
                                        "description": "Number of items."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "Is replaced by the product name when you send a `product_id`."
                                    },
                                    "price_incl": {
                                        "type": "number",
                                        "description": "Price per item incl. VAT. Needed when you do not send a `product_id`."
                                    },
                                    "product_id": {
                                        "type": "string",
                                        "description": "ID of a product. The product name and tax rate are used."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate. Only without a `product_id`."
                                    },
                                    "information": {
                                        "type": "string",
                                        "description": "Extra information on the line."
                                    }
                                },
                                "required": [
                                    "number",
                                    "description"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "2319201102164",
                                    "type": "product",
                                    "number": 8,
                                    "description": "Bottle of red wine",
                                    "total_price_incl_vat": 352,
                                    "total_price_excl_vat": 317.12,
                                    "piece_price_incl_vat": 44,
                                    "piece_price_excl_vat": 39.64,
                                    "tax_amount": 34.88,
                                    "tax_rate": 11,
                                    "tax_type": "standard",
                                    "product_id": null
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Line ID."
                                        },
                                        "type": {
                                            "type": "string",
                                            "description": "`logies` or `product`."
                                        },
                                        "number": {
                                            "type": "number",
                                            "description": "Number of items."
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "total_price_incl_vat": {
                                            "type": "number",
                                            "description": "Total of the line incl. VAT."
                                        },
                                        "total_price_excl_vat": {
                                            "type": "number",
                                            "description": "Total of the line excl. VAT."
                                        },
                                        "piece_price_incl_vat": {
                                            "type": "number",
                                            "description": "Price per item incl. VAT."
                                        },
                                        "piece_price_excl_vat": {
                                            "type": "number",
                                            "description": "Price per item excl. VAT."
                                        },
                                        "tax_amount": {
                                            "type": "number",
                                            "description": "VAT amount of the line."
                                        },
                                        "tax_rate": {
                                            "type": "number",
                                            "nullable": true,
                                            "description": "VAT percentage."
                                        },
                                        "tax_type": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "`standard`, `zero` or `exempt` (no VAT). See tax rates."
                                        },
                                        "product_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the product, or `null` for a line added by hand."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/lines/{LINE_ID}": {
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Update a product line",
                "operationId": "invoicesLineUpdate",
                "description": "Changes only the fields you send.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "LINE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "number": {
                                        "type": "integer",
                                        "description": "Number of items."
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "price_incl": {
                                        "type": "number",
                                        "description": "Price per item incl. VAT."
                                    },
                                    "product_id": {
                                        "type": "string",
                                        "description": "ID of a product."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "number": {
                                        "type": "integer",
                                        "description": "Number of items."
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "price_incl": {
                                        "type": "number",
                                        "description": "Price per item incl. VAT."
                                    },
                                    "product_id": {
                                        "type": "string",
                                        "description": "ID of a product."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "2319201102164",
                                    "type": "product",
                                    "number": 8,
                                    "description": "Bottle of red wine",
                                    "total_price_incl_vat": 352,
                                    "total_price_excl_vat": 317.12,
                                    "piece_price_incl_vat": 44,
                                    "piece_price_excl_vat": 39.64,
                                    "tax_amount": 34.88,
                                    "tax_rate": 11,
                                    "tax_type": "standard",
                                    "product_id": null
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Line ID."
                                        },
                                        "type": {
                                            "type": "string",
                                            "description": "`logies` or `product`."
                                        },
                                        "number": {
                                            "type": "number",
                                            "description": "Number of items."
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "total_price_incl_vat": {
                                            "type": "number",
                                            "description": "Total of the line incl. VAT."
                                        },
                                        "total_price_excl_vat": {
                                            "type": "number",
                                            "description": "Total of the line excl. VAT."
                                        },
                                        "piece_price_incl_vat": {
                                            "type": "number",
                                            "description": "Price per item incl. VAT."
                                        },
                                        "piece_price_excl_vat": {
                                            "type": "number",
                                            "description": "Price per item excl. VAT."
                                        },
                                        "tax_amount": {
                                            "type": "number",
                                            "description": "VAT amount of the line."
                                        },
                                        "tax_rate": {
                                            "type": "number",
                                            "nullable": true,
                                            "description": "VAT percentage."
                                        },
                                        "tax_type": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "`standard`, `zero` or `exempt` (no VAT). See tax rates."
                                        },
                                        "product_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the product, or `null` for a line added by hand."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Remove a product line",
                "operationId": "invoicesLineDelete",
                "description": "Removes the line and returns it.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "LINE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/payments": {
            "get": {
                "tags": [
                    "Invoices"
                ],
                "summary": "List all payments",
                "operationId": "invoicesPaymentsList",
                "description": "Returns all payments in the period, of all invoices. `from` and `until` may be at most 36 days apart.",
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-11-01"
                    },
                    {
                        "name": "until",
                        "in": "query",
                        "required": true,
                        "description": "Format `YYYY-MM-DD`.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "2030-11-30"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192011021",
                                        "invoice": "F2030-0012",
                                        "payment_method": "bank_card",
                                        "amount": "10.00",
                                        "description": "",
                                        "created_at": "2030-11-04 10:12:00"
                                    }
                                ]
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/payments": {
            "post": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Add a payment",
                "operationId": "invoicesPaymentAdd",
                "description": "Registers a payment on the invoice. We do not send the guest a notification for payments you add via the API.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "payment_type": {
                                        "type": "string",
                                        "description": "`bank_transfer`, `bank_card`, `credit_card`, `cash`, `voucher`, `channel`, `cheque` or `provider`."
                                    },
                                    "amount": {
                                        "type": "number",
                                        "description": "For a refund, send a negative amount."
                                    },
                                    "description": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "payment_type",
                                    "amount"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "payment_type": {
                                        "type": "string",
                                        "description": "`bank_transfer`, `bank_card`, `credit_card`, `cash`, `voucher`, `channel`, `cheque` or `provider`."
                                    },
                                    "amount": {
                                        "type": "number",
                                        "description": "For a refund, send a negative amount."
                                    },
                                    "description": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "payment_type",
                                    "amount"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192011021",
                                    "payment_method": "bank_card",
                                    "amount": 10,
                                    "description": "Paid at the reception"
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Payment ID. Use it to remove the payment."
                                        },
                                        "payment_method": {
                                            "type": "string",
                                            "description": "See the parameter `payment_type`."
                                        },
                                        "amount": {
                                            "type": "number",
                                            "description": "Negative for a refund."
                                        },
                                        "description": {
                                            "type": "string",
                                            "nullable": true
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/payments/{PAYMENT_ID}": {
            "delete": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Remove a payment",
                "operationId": "invoicesPaymentDelete",
                "description": "Removes the payment and returns it.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "PAYMENT_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192011021",
                                    "payment_method": "bank_card",
                                    "amount": 10,
                                    "description": "Paid at the reception"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/invoices/{INVOICE_ID}/pdf": {
            "get": {
                "tags": [
                    "Invoices"
                ],
                "summary": "Download an invoice",
                "operationId": "invoicesPdf",
                "description": "Returns the invoice as PDF (`application/pdf`). The authorization header is still required.",
                "parameters": [
                    {
                        "name": "INVOICE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/pdf": {
                                "schema": {
                                    "type": "string",
                                    "format": "binary"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/roomtypes": {
            "get": {
                "tags": [
                    "Roomtypes"
                ],
                "summary": "List all roomtypes",
                "operationId": "roomtypesList",
                "description": "Returns all roomtypes with their rooms, pictures and price rates.",
                "parameters": [
                    {
                        "name": "language",
                        "in": "query",
                        "required": false,
                        "description": "ISO 639-1, for example `en`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "81912063",
                                        "type": "double",
                                        "number_of_rooms": 3,
                                        "name": "Doubleroom Deluxe with balcony",
                                        "square_meters": 20,
                                        "amenities": [
                                            "safe",
                                            "sofa",
                                            "hair_dryer",
                                            "seating_area"
                                        ],
                                        "public_names": {
                                            "nl": "Luxe tweepersoonskamer",
                                            "en": "Luxury double room",
                                            "de": "..."
                                        },
                                        "public_descriptions": {
                                            "nl": "Deze kamer is van alle luxe voorzien!",
                                            "en": "This room is equipped with every luxury!",
                                            "de": "..."
                                        },
                                        "default_picture": "https://cdn.mytourist.cloud/rooms/medium/21MTYZ....jpg",
                                        "pictures": [
                                            "https://cdn.mytourist.cloud/rooms/medium/21MTWN....jpg",
                                            "https://cdn.mytourist.cloud/rooms/medium/21MTYZ....jpg"
                                        ],
                                        "rooms": [
                                            {
                                                "id": "66118888",
                                                "name": "Room 1"
                                            },
                                            {
                                                "id": "66118777",
                                                "name": "Room 4"
                                            },
                                            {
                                                "id": "66118666",
                                                "name": "Room 8"
                                            }
                                        ],
                                        "rates": [
                                            {
                                                "id": "66118004",
                                                "name": "Conform arrangement",
                                                "public_names": {
                                                    "nl": "Standaardprijs 2 personen",
                                                    "en": "Standard price 2 persons"
                                                }
                                            }
                                        ]
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Roomtype ID. Use it as `roomtype_id` in other endpoints."
                                            },
                                            "type": {
                                                "type": "string",
                                                "description": "Kind of roomtype, for example `double`."
                                            },
                                            "number_of_rooms": {
                                                "type": "integer"
                                            },
                                            "name": {
                                                "type": "string",
                                                "description": "Internal name."
                                            },
                                            "square_meters": {
                                                "type": "integer",
                                                "nullable": true
                                            },
                                            "amenities": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                },
                                                "description": "Codes of the amenities, for example `safe` or `hair_dryer`."
                                            },
                                            "public_names": {
                                                "type": "object",
                                                "description": "Name in the booking engine per language."
                                            },
                                            "public_descriptions": {
                                                "type": "object",
                                                "description": "Description per language."
                                            },
                                            "default_picture": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "URL of the main picture."
                                            },
                                            "pictures": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                },
                                                "description": "URLs of all pictures."
                                            },
                                            "rooms": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            },
                                            "rates": {
                                                "type": "array",
                                                "items": {
                                                    "type": "object"
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/price-rates": {
            "get": {
                "tags": [
                    "Price rates"
                ],
                "summary": "List all price rates",
                "operationId": "priceRatesList",
                "description": "Returns the price rates of one roomtype, or of all roomtypes.",
                "parameters": [
                    {
                        "name": "roomtype_id",
                        "in": "query",
                        "required": false,
                        "description": "Recommended. Only return the price rates of this roomtype.",
                        "schema": {
                            "type": "string"
                        },
                        "example": "23192010281"
                    },
                    {
                        "name": "language",
                        "in": "query",
                        "required": false,
                        "description": "ISO 639-1, for example `en`.",
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192010281",
                                        "default_price_per_night": "70.00",
                                        "price_per_night_percentage": false,
                                        "...": "..."
                                    },
                                    {
                                        "id": "23192011041",
                                        "parent_id": "23192010281",
                                        "roomtype_id": "23192010281",
                                        "internal_name": "Long weekend",
                                        "public_name": {
                                            "nl": "Lang weekend",
                                            "de": "Verlängertes Wochenende"
                                        },
                                        "note": "Only bookable in the weekends. Based on the main price with -10%",
                                        "enabled_for_booking_engine": true,
                                        "persons": 2,
                                        "min_stay": 4,
                                        "max_stay": null,
                                        "min_advance": 24,
                                        "max_advance": 24,
                                        "closed_on_arrival": "mo,tu,we,th,sa,su",
                                        "closed_on_departure": "tu,we,th,fr,sa",
                                        "default_price_per_night": "10.00",
                                        "price_per_night_percentage": true,
                                        "created_at": "2030-11-04 12:21:29",
                                        "updated_at": "2030-11-04 12:21:29"
                                    }
                                ]
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/price-rates/{RATE_ID}": {
            "get": {
                "tags": [
                    "Price rates"
                ],
                "summary": "Retrieve a price rate",
                "operationId": "priceRatesShow",
                "description": "Returns one price rate, in the same format as the list. The same query parameters can be used.",
                "parameters": [
                    {
                        "name": "RATE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/tax-rates": {
            "get": {
                "tags": [
                    "Tax rates"
                ],
                "summary": "List all tax rates",
                "operationId": "taxRatesList",
                "description": "Returns all your tax rates.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192011033",
                                        "label": "Low",
                                        "rate": 9,
                                        "type": "standard",
                                        "invoice_note": null,
                                        "created_at": "2030-11-03T09:52:42.000000Z",
                                        "updated_at": "2030-11-03T09:52:42.000000Z"
                                    },
                                    {
                                        "id": "23192011034",
                                        "label": "High",
                                        "rate": 21,
                                        "type": "standard",
                                        "invoice_note": null,
                                        "created_at": "2030-11-03T09:52:46.000000Z",
                                        "updated_at": "2030-11-03T09:52:46.000000Z"
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Tax rate ID. Use it as `tax_id` in products and invoice lines."
                                            },
                                            "label": {
                                                "type": "string"
                                            },
                                            "rate": {
                                                "type": "number",
                                                "description": "Percentage. Always `0` for the types `zero` and `exempt`."
                                            },
                                            "type": {
                                                "type": "string",
                                                "description": "`standard` (a percentage), `zero` (a real 0% VAT rate) or `exempt` (no VAT: exempt or outside the scope of VAT). See the table."
                                            },
                                            "invoice_note": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Text shown on invoices and quotations that use this rate, for example the legal ground for the exemption."
                                            },
                                            "created_at": {
                                                "type": "string",
                                                "description": "ISO 8601."
                                            },
                                            "updated_at": {
                                                "type": "string",
                                                "description": "ISO 8601."
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Tax rates"
                ],
                "summary": "Create a tax rate",
                "operationId": "taxRatesCreate",
                "description": "Creates a tax rate and returns it.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "label": {
                                        "type": "string"
                                    },
                                    "rate": {
                                        "type": "number",
                                        "description": "Percentage. Ignored (set to `0`) for the types `zero` and `exempt`."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`standard` (default), `zero` or `exempt`. See the table."
                                    },
                                    "invoice_note": {
                                        "type": "string",
                                        "description": "Text on the invoice, max. 500 characters. For example `Exempt from VAT under article 11`."
                                    }
                                },
                                "required": [
                                    "label",
                                    "rate"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "label": {
                                        "type": "string"
                                    },
                                    "rate": {
                                        "type": "number",
                                        "description": "Percentage. Ignored (set to `0`) for the types `zero` and `exempt`."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`standard` (default), `zero` or `exempt`. See the table."
                                    },
                                    "invoice_note": {
                                        "type": "string",
                                        "description": "Text on the invoice, max. 500 characters. For example `Exempt from VAT under article 11`."
                                    }
                                },
                                "required": [
                                    "label",
                                    "rate"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192011034",
                                    "label": "High",
                                    "rate": 21,
                                    "type": "standard",
                                    "invoice_note": null,
                                    "created_at": "2030-11-03T09:52:46.000000Z",
                                    "updated_at": "2030-11-03T09:52:46.000000Z"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/tax-rates/{RATE_ID}": {
            "post": {
                "tags": [
                    "Tax rates"
                ],
                "summary": "Update a tax rate",
                "operationId": "taxRatesUpdate",
                "description": "Changes the fields you send and returns the tax rate.",
                "parameters": [
                    {
                        "name": "RATE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "label": {
                                        "type": "string"
                                    },
                                    "rate": {
                                        "type": "number",
                                        "description": "Percentage. Ignored (set to `0`) for the types `zero` and `exempt`."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`standard`, `zero` or `exempt`."
                                    },
                                    "invoice_note": {
                                        "type": "string",
                                        "description": "Text on the invoice. Send an empty value to remove it."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "label": {
                                        "type": "string"
                                    },
                                    "rate": {
                                        "type": "number",
                                        "description": "Percentage. Ignored (set to `0`) for the types `zero` and `exempt`."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`standard`, `zero` or `exempt`."
                                    },
                                    "invoice_note": {
                                        "type": "string",
                                        "description": "Text on the invoice. Send an empty value to remove it."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192011034",
                                    "label": "High",
                                    "rate": 21,
                                    "type": "standard",
                                    "invoice_note": null,
                                    "created_at": "2030-11-03T09:52:46.000000Z",
                                    "updated_at": "2030-11-03T09:52:46.000000Z"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Tax rates"
                ],
                "summary": "Delete a tax rate",
                "operationId": "taxRatesDelete",
                "description": "Invoice lines can still refer to this rate. Existing invoices keep their calculated amounts, but when you change such a line later, no tax is calculated anymore.",
                "parameters": [
                    {
                        "name": "RATE_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/products": {
            "get": {
                "tags": [
                    "Products"
                ],
                "summary": "List all products",
                "operationId": "productsList",
                "description": "Returns all your products.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192011031",
                                        "category": {
                                            "id": "23192010291",
                                            "name": "Rental",
                                            "color": "#55BB5A"
                                        },
                                        "tax_id": "23192011034",
                                        "language": "en",
                                        "price": 14,
                                        "name": "Bike rental",
                                        "description": "Electric bike.",
                                        "translations": {
                                            "name": {
                                                "de": "Fahrradverleih",
                                                "...": "..."
                                            },
                                            "description": {
                                                "de": "Elektrisches Fahrrad",
                                                "...": "..."
                                            }
                                        },
                                        "calculation_methods": [
                                            "person",
                                            "night"
                                        ]
                                    },
                                    {
                                        "...": "..."
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Product ID. Use it as `product_id` in invoice lines."
                                            },
                                            "category": {
                                                "type": "object",
                                                "description": "The product category: `id`, `name`, `color`."
                                            },
                                            "tax_id": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ID of the tax rate."
                                            },
                                            "language": {
                                                "type": "string",
                                                "description": "Language of `name` and `description`."
                                            },
                                            "price": {
                                                "type": "number",
                                                "description": "Price per piece incl. VAT."
                                            },
                                            "name": {
                                                "type": "string"
                                            },
                                            "description": {
                                                "type": "string"
                                            },
                                            "translations": {
                                                "type": "object",
                                                "description": "Automatic translations of `name` and `description` per language."
                                            },
                                            "calculation_methods": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                },
                                                "description": "`person` and/or `night`: the price is multiplied by the number of guests and/or nights."
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Products"
                ],
                "summary": "Create a product",
                "operationId": "productsCreate",
                "description": "We advise to write `name` and `description` in the language of your invoices, so your invoices do not show an automatic translation. Translations of `name` and `description` are made automatically 30 minutes after your last change.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "language": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `fr` or `en`: the language of `name` and `description`."
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "price": {
                                        "type": "number",
                                        "description": "Price per piece."
                                    },
                                    "category_id": {
                                        "type": "string",
                                        "description": "ID of a product category."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    },
                                    "calculation_methods": {
                                        "type": "string",
                                        "description": "`person` and/or `night`, separated by a comma. The price is then multiplied by the number of guests and/or nights."
                                    },
                                    "auto_add_when_booked_on_roomtypes": {
                                        "type": "string",
                                        "description": "IDs of roomtypes, separated by commas. The product is added to every booking of these roomtypes, for example final cleaning."
                                    }
                                },
                                "required": [
                                    "language",
                                    "name",
                                    "description",
                                    "price"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "language": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `fr` or `en`: the language of `name` and `description`."
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "price": {
                                        "type": "number",
                                        "description": "Price per piece."
                                    },
                                    "category_id": {
                                        "type": "string",
                                        "description": "ID of a product category."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    },
                                    "calculation_methods": {
                                        "type": "string",
                                        "description": "`person` and/or `night`, separated by a comma. The price is then multiplied by the number of guests and/or nights."
                                    },
                                    "auto_add_when_booked_on_roomtypes": {
                                        "type": "string",
                                        "description": "IDs of roomtypes, separated by commas. The product is added to every booking of these roomtypes, for example final cleaning."
                                    }
                                },
                                "required": [
                                    "language",
                                    "name",
                                    "description",
                                    "price"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the created product."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/products/{PRODUCT_ID}": {
            "get": {
                "tags": [
                    "Products"
                ],
                "summary": "Retrieve a product",
                "operationId": "productsShow",
                "description": "Returns one product.",
                "parameters": [
                    {
                        "name": "PRODUCT_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "23192011031",
                                    "category": {
                                        "id": "23192010291",
                                        "name": "Rental",
                                        "color": "#55BB5A"
                                    },
                                    "tax_id": "23192011034",
                                    "language": "en",
                                    "price": 14,
                                    "name": "Bike rental",
                                    "description": "Electric bike.",
                                    "translations": {
                                        "name": {
                                            "de": "Fahrradverleih",
                                            "...": "..."
                                        },
                                        "description": {
                                            "de": "Elektrisches Fahrrad",
                                            "...": "..."
                                        }
                                    },
                                    "calculation_methods": [
                                        "person",
                                        "night"
                                    ]
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Product ID. Use it as `product_id` in invoice lines."
                                        },
                                        "category": {
                                            "type": "object",
                                            "description": "The product category: `id`, `name`, `color`."
                                        },
                                        "tax_id": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ID of the tax rate."
                                        },
                                        "language": {
                                            "type": "string",
                                            "description": "Language of `name` and `description`."
                                        },
                                        "price": {
                                            "type": "number",
                                            "description": "Price per piece incl. VAT."
                                        },
                                        "name": {
                                            "type": "string"
                                        },
                                        "description": {
                                            "type": "string"
                                        },
                                        "translations": {
                                            "type": "object",
                                            "description": "Automatic translations of `name` and `description` per language."
                                        },
                                        "calculation_methods": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "`person` and/or `night`: the price is multiplied by the number of guests and/or nights."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Products"
                ],
                "summary": "Update a product",
                "operationId": "productsUpdate",
                "description": "The same as creating, but no field is required. Only the fields you send are changed (also empty ones).",
                "parameters": [
                    {
                        "name": "PRODUCT_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "language": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `fr` or `en`: the language of `name` and `description`."
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "price": {
                                        "type": "number",
                                        "description": "Price per piece."
                                    },
                                    "category_id": {
                                        "type": "string",
                                        "description": "ID of a product category."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    },
                                    "calculation_methods": {
                                        "type": "string",
                                        "description": "`person` and/or `night`, separated by a comma. The price is then multiplied by the number of guests and/or nights."
                                    },
                                    "auto_add_when_booked_on_roomtypes": {
                                        "type": "string",
                                        "description": "IDs of roomtypes, separated by commas. The product is added to every booking of these roomtypes, for example final cleaning."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "language": {
                                        "type": "string",
                                        "description": "`nl`, `de`, `fr` or `en`: the language of `name` and `description`."
                                    },
                                    "name": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "description": {
                                        "type": "string",
                                        "description": "In the language you set."
                                    },
                                    "price": {
                                        "type": "number",
                                        "description": "Price per piece."
                                    },
                                    "category_id": {
                                        "type": "string",
                                        "description": "ID of a product category."
                                    },
                                    "tax_id": {
                                        "type": "string",
                                        "description": "ID of a tax rate."
                                    },
                                    "calculation_methods": {
                                        "type": "string",
                                        "description": "`person` and/or `night`, separated by a comma. The price is then multiplied by the number of guests and/or nights."
                                    },
                                    "auto_add_when_booked_on_roomtypes": {
                                        "type": "string",
                                        "description": "IDs of roomtypes, separated by commas. The product is added to every booking of these roomtypes, for example final cleaning."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "Returns the updated product."
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Products"
                ],
                "summary": "Remove a product",
                "operationId": "productsDelete",
                "description": "Proforma invoices are not changed. To remove the product from those invoices too, remove the product lines.",
                "parameters": [
                    {
                        "name": "PRODUCT_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/product-categories": {
            "get": {
                "tags": [
                    "Product categories"
                ],
                "summary": "List all product categories",
                "operationId": "productCategoriesList",
                "description": "The first item is always the default category, marked as `locked`. You cannot change it; all other categories are free to change.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "23192010291",
                                        "name": null,
                                        "color": "55BB5A",
                                        "locked": true,
                                        "created_at": "2030-10-29 13:58:07",
                                        "updated_at": "2030-10-29 13:58:07"
                                    },
                                    {
                                        "id": "23192011032",
                                        "name": "Bike rental",
                                        "color": "e44a7c",
                                        "locked": false,
                                        "created_at": "2030-11-03 15:11:41",
                                        "updated_at": "2030-11-03 15:11:41"
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Category ID. Use it as `category_id` in products."
                                            },
                                            "name": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "`null` for the default category."
                                            },
                                            "color": {
                                                "type": "string",
                                                "description": "HEX color without `#`."
                                            },
                                            "locked": {
                                                "type": "boolean",
                                                "description": "The default category; it cannot be changed or removed."
                                            },
                                            "created_at": {
                                                "type": "string"
                                            },
                                            "updated_at": {
                                                "type": "string"
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Product categories"
                ],
                "summary": "Create a product category",
                "operationId": "productCategoriesCreate",
                "description": "Creates a category and returns it.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string",
                                        "description": "For internal use only."
                                    },
                                    "color": {
                                        "type": "string",
                                        "description": "HEX color, for example `e44a7c`."
                                    }
                                },
                                "required": [
                                    "name"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string",
                                        "description": "For internal use only."
                                    },
                                    "color": {
                                        "type": "string",
                                        "description": "HEX color, for example `e44a7c`."
                                    }
                                },
                                "required": [
                                    "name"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/product-categories/{CATEGORY_ID}": {
            "post": {
                "tags": [
                    "Product categories"
                ],
                "summary": "Update a product category",
                "operationId": "productCategoriesUpdate",
                "description": "Changes the fields you send. The locked default category cannot be changed (`Category locked`).",
                "parameters": [
                    {
                        "name": "CATEGORY_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "color": {
                                        "type": "string",
                                        "description": "HEX color."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "name": {
                                        "type": "string"
                                    },
                                    "color": {
                                        "type": "string",
                                        "description": "HEX color."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Product categories"
                ],
                "summary": "Remove a product category",
                "operationId": "productCategoriesDelete",
                "description": "All products in this category move to the locked default category.",
                "parameters": [
                    {
                        "name": "CATEGORY_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/vouchers": {
            "get": {
                "tags": [
                    "Vouchers"
                ],
                "summary": "List all vouchers",
                "operationId": "vouchersList",
                "description": "Returns all available vouchers and discount codes.",
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": [
                                    {
                                        "id": "04250025",
                                        "code": "4863-6862",
                                        "type": "discount",
                                        "is_percentage": false,
                                        "amount": "50.00",
                                        "label": "Spring",
                                        "description": "Example discount",
                                        "expires_at": "2030-04-19T22:00:00.000000Z",
                                        "language": "en",
                                        "limit_date_from": "2030-03-31T22:00:00.000000Z",
                                        "limit_date_until": "2030-04-09T22:00:00.000000Z",
                                        "times_to_use": 3,
                                        "excluded_rates": []
                                    },
                                    {
                                        "...": "..."
                                    }
                                ],
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "type": "string",
                                                "description": "Voucher ID. Use it for the other voucher endpoints."
                                            },
                                            "code": {
                                                "type": "string",
                                                "description": "The code the guest enters."
                                            },
                                            "type": {
                                                "type": "string",
                                                "description": "`discount` or `voucher`."
                                            },
                                            "is_percentage": {
                                                "type": "boolean",
                                                "description": "`amount` is a percentage."
                                            },
                                            "amount": {
                                                "type": "string",
                                                "description": "Amount or percentage."
                                            },
                                            "label": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "description": {
                                                "type": "string",
                                                "nullable": true
                                            },
                                            "expires_at": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "ISO 8601."
                                            },
                                            "language": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Only for type `voucher`."
                                            },
                                            "limit_date_from": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Only for type `discount`: valid for stays from this date."
                                            },
                                            "limit_date_until": {
                                                "type": "string",
                                                "nullable": true,
                                                "description": "Only for type `discount`: valid for stays until this date."
                                            },
                                            "times_to_use": {
                                                "type": "integer",
                                                "nullable": true,
                                                "description": "Only for type `discount`: how often the code can be used."
                                            },
                                            "excluded_rates": {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                },
                                                "description": "IDs of price rates the code does not apply to. Empty: valid for all rates."
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Vouchers"
                ],
                "summary": "Create a voucher",
                "operationId": "vouchersCreate",
                "description": "Creates a voucher or discount code and returns it.",
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": "number",
                                        "description": "Amount, or percentage when `is_percentage` is `true`."
                                    },
                                    "code": {
                                        "type": "string",
                                        "description": "Discount code. Generated automatically when empty."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`discount` (default) or `voucher`."
                                    },
                                    "is_percentage": {
                                        "type": "boolean",
                                        "description": "Default `false`."
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "expires_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1. Only for type `voucher`."
                                    },
                                    "limit_date_from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "limit_date_until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "times_to_use": {
                                        "type": "integer",
                                        "description": "Only for type `discount`."
                                    },
                                    "excluded_rates": {
                                        "type": "string",
                                        "description": "IDs of price rates the code does not apply to, separated by commas. Default: valid for all rates. Send it empty to clear it."
                                    }
                                },
                                "required": [
                                    "amount"
                                ]
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": "number",
                                        "description": "Amount, or percentage when `is_percentage` is `true`."
                                    },
                                    "code": {
                                        "type": "string",
                                        "description": "Discount code. Generated automatically when empty."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`discount` (default) or `voucher`."
                                    },
                                    "is_percentage": {
                                        "type": "boolean",
                                        "description": "Default `false`."
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "expires_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1. Only for type `voucher`."
                                    },
                                    "limit_date_from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "limit_date_until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "times_to_use": {
                                        "type": "integer",
                                        "description": "Only for type `discount`."
                                    },
                                    "excluded_rates": {
                                        "type": "string",
                                        "description": "IDs of price rates the code does not apply to, separated by commas. Default: valid for all rates. Send it empty to clear it."
                                    }
                                },
                                "required": [
                                    "amount"
                                ]
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "04250025",
                                    "code": "4863-6862",
                                    "type": "discount",
                                    "is_percentage": false,
                                    "amount": "50.00",
                                    "label": "Spring",
                                    "description": "Example discount",
                                    "expires_at": "2030-04-19T22:00:00.000000Z",
                                    "language": "en",
                                    "limit_date_from": "2030-03-31T22:00:00.000000Z",
                                    "limit_date_until": "2030-04-09T22:00:00.000000Z",
                                    "times_to_use": 3,
                                    "excluded_rates": []
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        },
        "/vouchers/{VOUCHER_ID}": {
            "get": {
                "tags": [
                    "Vouchers"
                ],
                "summary": "Retrieve a voucher",
                "operationId": "vouchersShow",
                "description": "Returns one voucher.",
                "parameters": [
                    {
                        "name": "VOUCHER_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "04250025",
                                    "code": "4863-6862",
                                    "type": "discount",
                                    "is_percentage": false,
                                    "amount": "50.00",
                                    "label": "Spring",
                                    "description": "Example discount",
                                    "expires_at": "2030-04-19T22:00:00.000000Z",
                                    "language": "en",
                                    "limit_date_from": "2030-03-31T22:00:00.000000Z",
                                    "limit_date_until": "2030-04-09T22:00:00.000000Z",
                                    "times_to_use": 3,
                                    "excluded_rates": []
                                },
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "type": "string",
                                            "description": "Voucher ID. Use it for the other voucher endpoints."
                                        },
                                        "code": {
                                            "type": "string",
                                            "description": "The code the guest enters."
                                        },
                                        "type": {
                                            "type": "string",
                                            "description": "`discount` or `voucher`."
                                        },
                                        "is_percentage": {
                                            "type": "boolean",
                                            "description": "`amount` is a percentage."
                                        },
                                        "amount": {
                                            "type": "string",
                                            "description": "Amount or percentage."
                                        },
                                        "label": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "description": {
                                            "type": "string",
                                            "nullable": true
                                        },
                                        "expires_at": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "ISO 8601."
                                        },
                                        "language": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Only for type `voucher`."
                                        },
                                        "limit_date_from": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Only for type `discount`: valid for stays from this date."
                                        },
                                        "limit_date_until": {
                                            "type": "string",
                                            "nullable": true,
                                            "description": "Only for type `discount`: valid for stays until this date."
                                        },
                                        "times_to_use": {
                                            "type": "integer",
                                            "nullable": true,
                                            "description": "Only for type `discount`: how often the code can be used."
                                        },
                                        "excluded_rates": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "IDs of price rates the code does not apply to. Empty: valid for all rates."
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "post": {
                "tags": [
                    "Vouchers"
                ],
                "summary": "Update a voucher",
                "operationId": "vouchersUpdate",
                "description": "Send the full JSON or only the fields you want to change. A field you send is always overwritten; a field you leave out keeps its current value.",
                "parameters": [
                    {
                        "name": "VOUCHER_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": "number",
                                        "description": "Amount, or percentage when `is_percentage` is `true`."
                                    },
                                    "code": {
                                        "type": "string",
                                        "description": "Discount code. Generated automatically when empty."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`discount` (default) or `voucher`."
                                    },
                                    "is_percentage": {
                                        "type": "boolean",
                                        "description": "Default `false`."
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "expires_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1. Only for type `voucher`."
                                    },
                                    "limit_date_from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "limit_date_until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "times_to_use": {
                                        "type": "integer",
                                        "description": "Only for type `discount`."
                                    },
                                    "excluded_rates": {
                                        "type": "string",
                                        "description": "IDs of price rates the code does not apply to, separated by commas. Default: valid for all rates. Send it empty to clear it."
                                    }
                                }
                            }
                        },
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "amount": {
                                        "type": "number",
                                        "description": "Amount, or percentage when `is_percentage` is `true`."
                                    },
                                    "code": {
                                        "type": "string",
                                        "description": "Discount code. Generated automatically when empty."
                                    },
                                    "type": {
                                        "type": "string",
                                        "description": "`discount` (default) or `voucher`."
                                    },
                                    "is_percentage": {
                                        "type": "boolean",
                                        "description": "Default `false`."
                                    },
                                    "label": {
                                        "type": "string"
                                    },
                                    "description": {
                                        "type": "string"
                                    },
                                    "expires_at": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD HH:MM:SS`."
                                    },
                                    "language": {
                                        "type": "string",
                                        "description": "ISO 639-1. Only for type `voucher`."
                                    },
                                    "limit_date_from": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "limit_date_until": {
                                        "type": "string",
                                        "description": "Format `YYYY-MM-DD`. Only for type `discount`."
                                    },
                                    "times_to_use": {
                                        "type": "integer",
                                        "description": "Only for type `discount`."
                                    },
                                    "excluded_rates": {
                                        "type": "string",
                                        "description": "IDs of price rates the code does not apply to, separated by commas. Default: valid for all rates. Send it empty to clear it."
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "example": {
                                    "id": "04250025",
                                    "code": "4863-6862",
                                    "type": "discount",
                                    "is_percentage": false,
                                    "amount": "50.00",
                                    "label": "Spring",
                                    "description": "Example discount",
                                    "expires_at": "2030-04-19T22:00:00.000000Z",
                                    "language": "en",
                                    "limit_date_from": "2030-03-31T22:00:00.000000Z",
                                    "limit_date_until": "2030-04-09T22:00:00.000000Z",
                                    "times_to_use": 3,
                                    "excluded_rates": []
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            },
            "delete": {
                "tags": [
                    "Vouchers"
                ],
                "summary": "Delete a voucher",
                "operationId": "vouchersDelete",
                "description": "Deletes the voucher or discount code.",
                "parameters": [
                    {
                        "name": "VOUCHER_ID",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    },
                    "400": {
                        "description": "Missing or invalid parameters, or the action is not allowed."
                    },
                    "403": {
                        "description": "Bearer token missing or not valid."
                    },
                    "404": {
                        "description": "Not found."
                    }
                }
            }
        }
    }
}