Bulk Check Product Availability

Check availability for multiple products in a single request. Useful for validating an entire cart before booking.

Endpoint

POST /v1/availability/products/bulk

Request Body

Field	Type	Required	Description
`items`	array	Yes	Array of products to check (max 50)
`items[].product_id`	integer	Yes	Product ID
`items[].variation_id`	integer	No	Variation ID
`items[].quantity`	integer	No	Quantity to check (default: 1)
`start_date`	string	Yes	Start date/time (ISO 8601)
`end_date`	string	Yes	End date/time (ISO 8601)

Example Request

curl -X POST "https://app.equipdash.com/api/v1/availability/products/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"product_id": 1, "quantity": 2},
      {"product_id": 5, "variation_id": 12, "quantity": 1},
      {"product_id": 8, "quantity": 3}
    ],
    "start_date": "2026-02-15T09:00:00Z",
    "end_date": "2026-02-17T17:00:00Z"
  }'

Response

{
  "data": {
    "all_available": false,
    "period": {
      "start_date": "2026-02-15T09:00:00+00:00",
      "end_date": "2026-02-17T17:00:00+00:00"
    },
    "items": [
      {
        "product_id": 1,
        "variation_id": null,
        "product_name": "Mountain Bike",
        "available": true,
        "available_quantity": 5,
        "bookable_quantity": 5,
        "requested_quantity": 2
      },
      {
        "product_id": 5,
        "variation_id": 12,
        "product_name": "Wetsuit",
        "available": true,
        "available_quantity": 3,
        "bookable_quantity": 3,
        "requested_quantity": 1
      },
      {
        "product_id": 8,
        "variation_id": null,
        "available": false,
        "available_quantity": 1,
        "bookable_quantity": 1,
        "requested_quantity": 3,
        "error": "Product not found"
      }
    ]
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-01T10:00:00+00:00"
  }
}

Response Fields

Field	Type	Description
`all_available`	boolean	`true` if ALL items are available
`period.start_date`	string	Requested start date
`period.end_date`	string	Requested end date
`items`	array	Results for each product
`items[].product_id`	integer	Product ID
`items[].variation_id`	integer\|null	Variation ID
`items[].product_name`	string	Product name (if found)
`items[].available`	boolean	Whether the requested quantity can be booked — computed as `bookable_quantity >= requested_quantity`
`items[].available_quantity`	integer	Units physically on hand for the window
`items[].bookable_quantity`	integer	Units that may actually be sold: on hand plus whatever is left of the product's shortage allowance. Identical to `available_quantity` unless the product has `allow_shortage` enabled
`items[].requested_quantity`	integer	What was requested
`items[].error`	string	Message explaining why the item could not be checked (e.g. the product was not found)

Products That Keep Selling When Sold Out

A product can be set to keep taking bookings after its on-hand stock is gone, up to a small allowance (allow_shortage / max_shortage — see Keep selling when sold out). Its row reports a bookable_quantity above available_quantity, and available follows bookable_quantity, so the item counts toward all_available:

{
  "product_id": 3,
  "variation_id": null,
  "product_name": "Helmet",
  "available": true,
  "available_quantity": 0,
  "bookable_quantity": 2,
  "requested_quantity": 2
}

The allowance is one shared budget per product — not per variation — and it is drawn down by bookings already flagged short over overlapping dates, then freed again by a cancellation. Kits are never sold short, and experiences do not use the allowance at all.

Use Cases

Validate Cart Before Checkout

# Check all cart items are available
curl -X POST "https://app.equipdash.com/api/v1/availability/products/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"product_id": 1, "quantity": 1},
      {"product_id": 2, "quantity": 2}
    ],
    "start_date": "2026-02-15T09:00:00Z",
    "end_date": "2026-02-17T17:00:00Z"
  }'

If all_available is true, proceed to create booking. Otherwise, show user which items are unavailable.

Check Alternative Dates

# If items unavailable, check different dates
curl -X POST "https://app.equipdash.com/api/v1/availability/products/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"product_id": 1, "quantity": 2}
    ],
    "start_date": "2026-02-22T09:00:00Z",
    "end_date": "2026-02-24T17:00:00Z"
  }'

Limits

Maximum 50 items per request
Each item is checked independently
Products not found or invalid variations are returned with error field

Endpoint​

Request Body​

Example Request​

Response​

Response Fields​

Products That Keep Selling When Sold Out​

Use Cases​

Validate Cart Before Checkout​

Check Alternative Dates​

Limits​