> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wilow.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Address

> Check coverage and save a customer's address

## Check Location Coverage

Check whether Wilow operates at a given location before proceeding with onboarding.

```http theme={null}
POST /external-partner/customers/is-location-covered
```

**Headers**

| Header            | Value                |
| ----------------- | -------------------- |
| `API-KEY`         | Your partner API key |
| `Idempotency-Key` | Unique UUID          |

**Body** `multipart/form-data`

| Field  | Type  | Required | Constraints              |
| ------ | ----- | -------- | ------------------------ |
| `lat`  | float | ✅        | Between `-90` and `90`   |
| `long` | float | ✅        | Between `-180` and `180` |

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "is_covered": true
  },
  "status_code": 200
}
```

If `is_covered` is `false`, stop the flow and show an out-of-coverage message.

***

## Save Address

Create or update the customer's pickup/delivery address. Uses the customer token.

```http theme={null}
POST /external-partner/customers/address
```

**Headers**

| Header            | Value                     |
| ----------------- | ------------------------- |
| `Authorization`   | `Bearer {customer_token}` |
| `Idempotency-Key` | Unique UUID               |

**Body** `multipart/form-data`

| Field              | Type   | Required | Notes                                   |
| ------------------ | ------ | -------- | --------------------------------------- |
| `lat`              | float  | ✅        |                                         |
| `long`             | float  | ✅        |                                         |
| `street_area`      | string | ✅        | Max 255 chars                           |
| `apartment_number` | string | ❌        |                                         |
| `building_number`  | string | ❌        |                                         |
| `home_type`        | string | ❌        | Max 255 chars                           |
| `notes`            | string | ❌        | Delivery notes, max 500 chars           |
| `delivery`         | string | ❌        | `call_when_arrive` or `pick_up_deliver` |

**Response**

```json theme={null}
{
  "success": true,
  "data": {
    "id": 2069,
    "lat": 24.83138,
    "long": 46.68362,
    "street_area": "King Fahd District",
    "apartment_number": null,
    "building_number": null,
    "home_type": null,
    "notes": null,
    "delivery": null,
    "is_served": true
  },
  "status_code": 200
}
```