# ADDRESS_OUT_OF_RANGE

# ADDRESS_OUT_OF_RANGE

The delivery address is geocodable but lies outside the merchant's delivery radius (or outside any merchant's radius for a discovery call).

*Reserved error code — not currently emitted by any endpoint. Partners may begin handling it defensively; backend will start emitting once wired in.*

## Summary

| Field | Value |
|---|---|
| HTTP status | `400` |
| `errorCategory` | `validation` |
| `retryable` | `false` |

## When This Fires

- **`POST /v1/marketfront/orders/validate`** / **`/place`** — the chosen store does not deliver to the address on the session's `fulfillment-context`.
- **`PUT /v1/marketfront/session/fulfillment-context`** — when policy rejects setting a delivery address that no merchant in the catalog serves (if enforced at context-set time).

## Recommended Action

Offer pickup at a nearby store, or surface stores that do deliver to this address:

1. Re-run discovery (`POST /v1/marketfront/stores/discover`) with the same address — only stores within range are returned.
2. Suggest pickup at the originally selected store if pickup is supported.
3. Surface the in-range stores as alternatives.

## Example

```json
{
  "type": "https://developer.gett-tech.com/errors/ADDRESS_OUT_OF_RANGE",
  "title": "Bad Request",
  "status": 400,
  "detail": "The delivery address is outside the store's delivery radius.",
  "instance": "/v1/marketfront/orders/validate",
  "requestId": "req_abc123",
  "timestamp": "2026-04-27T14:30:00.000Z",
  "errorCode": "ADDRESS_OUT_OF_RANGE",
  "errorCategory": "validation",
  "retryable": false
}
```