AIR Bandenservice Haarlem

Tyres for sale, filtered by size (e.g. 205/55R16), season and brand. Returns the all-in price per tyre (incl. VAT and disposal fee), whether it can be ordered now and how fast it is available. No side effects.

{
  "type": "object",
  "properties": {
    "size": {
      "type": "string",
      "description": "Tyre size as on the sidewall, e.g. 205/55R16 or 195/65R15."
    },
    "season": {
      "type": "string",
      "enum": [
        "summer",
        "winter",
        "all_season"
      ]
    },
    "brand": {
      "type": "string"
    },
    "orderableOnly": {
      "type": "boolean",
      "description": "Default true."
    }
  },
  "additionalProperties": false
}

Address, opening hours, phone, delivery fee, fitting price per tyre, payment methods and links to the Terms and privacy policy. No side effects.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Workshop days that still have room for fitting, in the next 4 weeks. No side effects.

{
  "type": "object",
  "properties": {
    "supplierItems": {
      "type": "boolean",
      "description": "true when a chosen tyre comes from the supplier (not in stock at the shop); those need a few working days to arrive, so the first days are left out."
    }
  },
  "additionalProperties": false
}

The exact total for these tyres and options, line by line, exactly what the payment page will charge. Checks stock and fitting capacity. Does not order, reserve, email or charge anything.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "description": "Tyres to order: the slug from search_tyres and how many. At most 4 products and 8 tyres per order.",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Product slug from search_tyres."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 8
          }
        },
        "required": [
          "slug",
          "qty"
        ],
        "additionalProperties": false
      }
    },
    "delivery": {
      "type": "string",
      "enum": [
        "pickup",
        "delivery"
      ],
      "description": "pickup = collect at the workshop in Haarlem (free); delivery = shipped to an address in the Netherlands (fee from get_shop_info)."
    },
    "fitting": {
      "type": "object",
      "description": "Optional: fitting and balancing at the workshop (pickup only), on a day from list_fitting_days.",
      "properties": {
        "day": {
          "type": "string",
          "description": "YYYY-MM-DD, from list_fitting_days."
        },
        "part": {
          "type": "string",
          "enum": [
            "morning",
            "afternoon"
          ]
        }
      },
      "required": [
        "day",
        "part"
      ],
      "additionalProperties": false
    },
    "tpms": {
      "type": "boolean",
      "description": "With fitting only: the car has tyre pressure sensors (TPMS). Adds the sensor surcharge."
    },
    "locale": {
      "type": "string",
      "enum": [
        "nl",
        "en",
        "de",
        "fr",
        "es",
        "it",
        "sv"
      ],
      "description": "Language of the payment page, the order page and the emails. Default nl."
    }
  },
  "required": [
    "items",
    "delivery"
  ],
  "additionalProperties": false
}

Creates an unpaid order for the given tyres and options and returns a Mollie checkoutUrl where the customer pays. Requires the customer's acceptance of the Terms (https://www.airbandenservice.com/nl/algemene-voorwaarden) and the total from get_quote; a different current total is refused. Nothing is ordered until the customer pays; an unpaid order expires after about 15 minutes. An identical repeat returns the same order.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "description": "Tyres to order: the slug from search_tyres and how many. At most 4 products and 8 tyres per order.",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "Product slug from search_tyres."
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 8
          }
        },
        "required": [
          "slug",
          "qty"
        ],
        "additionalProperties": false
      }
    },
    "delivery": {
      "type": "string",
      "enum": [
        "pickup",
        "delivery"
      ],
      "description": "pickup = collect at the workshop in Haarlem (free); delivery = shipped to an address in the Netherlands (fee from get_shop_info)."
    },
    "fitting": {
      "type": "object",
      "description": "Optional: fitting and balancing at the workshop (pickup only), on a day from list_fitting_days.",
      "properties": {
        "day": {
          "type": "string",
          "description": "YYYY-MM-DD, from list_fitting_days."
        },
        "part": {
          "type": "string",
          "enum": [
            "morning",
            "afternoon"
          ]
        }
      },
      "required": [
        "day",
        "part"
      ],
      "additionalProperties": false
    },
    "tpms": {
      "type": "boolean",
      "description": "With fitting only: the car has tyre pressure sensors (TPMS). Adds the sensor surcharge."
    },
    "locale": {
      "type": "string",
      "enum": [
        "nl",
        "en",
        "de",
        "fr",
        "es",
        "it",
        "sv"
      ],
      "description": "Language of the payment page, the order page and the emails. Default nl."
    },
    "customer": {
      "type": "object",
      "description": "The customer's own details, as they gave them.",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 2,
          "maxLength": 100
        },
        "email": {
          "type": "string",
          "description": "Receives the order confirmation and the receipt after payment."
        },
        "phone": {
          "type": "string",
          "description": "Optional, for questions about the order, e.g. 06 12345678 or +31 6 12345678."
        },
        "address": {
          "type": "string",
          "description": "Required for delivery and for a business order: street, house number, postcode and city in the Netherlands."
        },
        "postcode": {
          "type": "string",
          "description": "Dutch postcode, e.g. 2031 CV (optional when the address contains it)."
        },
        "licensePlate": {
          "type": "string",
          "description": "Dutch licence plate. Required with fitting."
        },
        "companyName": {
          "type": "string",
          "description": "Only for a business invoice."
        },
        "companyVatId": {
          "type": "string",
          "description": "Only for a business invoice, e.g. NL123456789B01."
        }
      },
      "required": [
        "name",
        "email"
      ],
      "additionalProperties": false
    },
    "expectedTotalCents": {
      "type": "integer",
      "description": "totalCents from get_quote. A different current total is refused, so the customer never pays more than the quoted amount."
    },
    "acceptedTerms": {
      "type": "boolean",
      "description": "Whether the customer accepted the Terms. The order is refused without it."
    }
  },
  "required": [
    "items",
    "delivery",
    "customer",
    "expectedTotalCents",
    "acceptedTerms"
  ],
  "additionalProperties": false
}

Payment and order status of an order placed with place_order (by its reference, e.g. AIR-2026-…). No personal data.

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string"
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}