# Availability API

Returns the earliest available delivery windows for a given store and destination. The response is pre-calculated based on enabled delivery types, store trading hours, pickup hours, public holidays, and cut-off logic.

Use this endpoint to power delivery time selection at checkout, or to determine the fastest available delivery type for backend routing decisions.

<Note>
  This endpoint is best used as an estimator. Delivery windows are calculated without considering distance or pricing rules — use the [Quote Delivery](/api-reference/deliveries/quote-a-delivery) endpoint when pricing accuracy is required.
</Note>

***

## Endpoint

```
POST {{domain}}/{{tenant_id}}/deliveries/quote/availability
```

**Authentication:** Bearer token required via the `Authorization` header.

***

## Request Payload

The request payload follows the same structure as the [Quote Delivery](/api-reference/deliveries/quote-a-delivery) endpoint.

```json title="POST /{{tenant_id}}/deliveries/quote/availability"
{
    "store_id": "rendr-store_001",
    "ready_for_pickup_at": "2025-03-12T12:00:00.000",
    "address": {
        "address": "100 Gould Street",
        "address2": "Unit 1",
        "city": "Bondi",
        "state": "NSW",
        "post_code": "2026"
    }
}
```

***

## Sample Response

Each available delivery type is returned with an estimated `from_datetime` and `to_datetime` window. Delivery types that are not available for the given store and destination will be omitted from the response.

```json title="200 OK"
{
    "fast": {
        "from_datetime": "2025-03-12T12:01:00+11:00",
        "to_datetime": "2025-03-12T15:01:00+11:00"
    },
    "flexible": {
        "from_datetime": "2025-03-13T09:01:00+11:00",
        "to_datetime": "2025-03-13T14:01:00+11:00"
    },
    "standard": {
        "from_datetime": "2025-03-13T09:01:00+11:00",
        "to_datetime": "2025-03-20T09:01:00+11:00"
    }
}
```

### Response Fields

| Field             | Type              | Description                                                               |
| ----------------- | ----------------- | ------------------------------------------------------------------------- |
| `fast`            | Object            | Estimated delivery window for the `fast` delivery type, if available.     |
| `flexible`        | Object            | Estimated delivery window for the `flexible` delivery type, if available. |
| `standard`        | Object            | Estimated delivery window for the `standard` delivery type, if available. |
| `express`         | Object            | Estimated delivery window for the `express` delivery type, if available.  |
| `*.from_datetime` | String (ISO 8601) | The start of the estimated delivery window.                               |
| `*.to_datetime`   | String (ISO 8601) | The end of the estimated delivery window.                                 |