Obtain Dates

Purpose

Returns the days on which a group of service variants can be executed together, in a single visit, at a location.

Use it after POST /api/integration/bundle/options: send the variants of one group, with the same quantities and addons, and then use POST /api/integration/bundle/times to get the start times of one of the returned days.

A group with a single variant returns the days available for that variant alone. Quantity and addons extend the duration of the visit exactly as they do when the booking is created.

Field Definitions

🔐 Authentication

🧩 Service variants

🏠 Location

When both are sent, addressId is used.

📅 Search range

Example Request

{
  "variants": [
    {
      "type": "variantSku",
      "value": "SKU-INSTALLATION",
      "quantity": 2,
      "addons": [
        { "type": "addonReference", "value": "ADDON-EXTRA-HOSE", "quantity": 1 }
      ]
    },
    { "type": "variantSku", "value": "SKU-MAINTENANCE" },
    { "type": "variantId", "value": "63", "quantity": 2 }
  ],
  "addressId": 17,
  "startDate": "2026-10-05",
  "quantityOfDays": 14
}

Single variant, by coordinates, from today:

{
  "variants": [
    { "type": "variantId", "value": "52" }
  ],
  "coordinates": { "lat": -33.42, "lng": -70.6 }
}

Response Example

201 Created

{
  "dates": [
    "2026-10-05",
    "2026-10-06",
    "2026-10-07",
    "2026-10-08",
    "2026-10-09",
    "2026-10-12"
  ]
}

Response Fields

Error Responses

Business Rules & Constraints

When a day is available

A day is returned when at least one provider that executes every variant of the group at the location has enough free time to execute all of them back to back, within the operating hours of the variants and respecting the booking anticipation, capacity and holidays that apply to a booking.

When several variants have different booking anticipation, the longest one applies to the whole group.

Duration of the visit

Each variant counts as variant duration × quantity, plus addon duration × addon quantity for each of its addons, the same duration the booking gets when it is created. The visit needs the sum of the durations of all the variants of the group in consecutive time. Very long visits that do not fit in one working day are searched as multi-day visits, as with any booking.

Variants without coverage

If any variant of the group is not offered at the location, the group cannot be executed there and dates is empty.

Search range

The search starts on startDate (today by default) and covers the following quantityOfDays days.

Identification

• A variant can be identified by id or by SKU, and both can be mixed in the same request.
• If two entries identify the same variant (for example its id and its SKU), the first one is used and the variant is counted once.

Addons

Each addon must be offered for its variant and must be offered at the location. Otherwise the request is rejected (see Error Responses); addons are never silently ignored.

Scope

Availability is computed for bookings without origin address, without products with a promised delivery date and with automatic provider assignment. When the booking is created with any of them, the offered days are indicative: the travel time from the origin, the delivery date of the products or the chosen provider may leave no availability for the group.