> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.rendr.delivery/llms.txt.
> For full documentation content, see https://docs.rendr.delivery/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rendr.delivery/_mcp/server.

# Quote API — Store Allocator

The [Quote Delivery](/api-reference/deliveries/quote-a-delivery) endpoint supports automatic store selection as part of the quoting process. Rather than specifying a single `store_id` or `store_reference`, you can pass a list of candidate stores and instruct Rendr to calculate the best fulfilment location on your behalf.

***

## How It Works

Set `rendr_store_allocator: true` in your quote request alongside an array of `store_ids` or `store_references`. Rendr evaluates each candidate store against the delivery destination using your configured [location selection strategy](/api-reference/store-allocation/allocation-api) and returns a single `store_id` in the response representing the optimal fulfilment location.

This removes the need to call the [Allocation API](/api-reference/store-allocation/allocation-api) separately before quoting — the allocation is resolved inline as part of the quote.

***

## Endpoint

```http
POST {domain}/{tenant_id}/deliveries/quote-next-available
```

***

## Request

Extend a standard quote request with the following fields:

| Field                   | Type    | Required | Description                                                                                                                                           |
| ----------------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `store_ids`             | Array   | No\*     | Array of Rendr store IDs to consider for fulfilment.                                                                                                  |
| `store_references`      | Array   | No\*     | Array of your internal store references to consider for fulfilment.                                                                                   |
| `rendr_store_allocator` | Boolean | Yes      | Set to `true` to enable automatic store selection. Rendr will select the best store from the provided list and return its `store_id` in the response. |

\*Either `store_ids` or `store_references` is required when `rendr_store_allocator` is `true`.

***

## Request Example

```json
{
    "store_ids": [
        "store_001",
        "store_002",
        "store_003"
    ],
    "rendr_store_allocator": true,
    "ready_for_pickup_at": "2025-03-12T12:00:00.000",
    "address": {
        "address": "7 Howard Street",
        "city": "Richmond",
        "state": "VIC",
        "post_code": "3121"
    },
    "line_items": [
        {
            "code": "sku-code-001",
            "name": "SKU Item Name #001",
            "price_cents": 999,
            "quantity": 1
        }
    ],
    "parcels": [
        {
            "reference": "PARCEL_001",
            "length_cm": 20,
            "width_cm": 40,
            "height_cm": 60,
            "weight_kg": 1,
            "quantity": 1,
            "type": "carton"
        }
    ]
}
```

***

## Response

The response follows the standard [Quote Delivery](/api-reference/deliveries/quote-a-delivery) structure with the addition of a `store_id` field at the top level, indicating the store Rendr selected as the best fulfilment location.

```json
{
    "store_id": "store_001",
    "data": {
        "fast": {
            "price_cents": 1342,
            "from_datetime": "2025-03-12T12:00:00+11:00",
            "to_datetime": "2025-03-12T15:00:00+11:00",
            "num_days": 0
        },
        "flexible": {
            "price_cents": 879,
            "from_datetime": "2025-03-12T12:00:00+11:00",
            "to_datetime": "2025-03-12T17:00:00+11:00",
            "num_days": 0
        },
        "standard": {
            "price_cents": 673,
            "from_datetime": "2025-03-12T12:00:00+11:00",
            "to_datetime": "2025-03-15T12:00:00+11:00",
            "num_days": 3,
            "provider": "Australia Post",
            "service": "PARCEL POST + SIGNATURE"
        }
    }
}
```

### Response Fields

| Field      | Type   | Description                                                                                                                                                              |
| ---------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `store_id` | String | The Rendr store ID of the selected fulfilment location, as determined by the store allocator. Use this value when booking the delivery.                                  |
| `data`     | Object | Standard quote response containing available delivery options and pricing. See [Get Delivery Quote](/api-reference/quote/get-delivery-quote) for full field definitions. |

The `store_id` returned in the response should be used as the `store_id` in your subsequent [Create Delivery](/api-reference/deliveries/create-a-delivery) request to ensure the order is assigned to the correct fulfilment location.