# Read the account's shipping policy

`GET /api/v1/address/policy`

- Authentication: Secret API key as a bearer token
- Billing: Free.
- Group: Address

The rules behind `ok_to_ship` on every address lookup this account runs: the signals that block, the risk-score ceiling, and whether a register must have confirmed the building. The policy belongs to the account, so every member reads and changes the same one. An address that cannot stand as written is always blocked whatever the policy says.

## Example request

```bash
curl https://spaw.co/api/v1/address/policy \
  -H "Authorization: Bearer sk_live_…"
```

## Responses

### 200 — The policy in force.

```json
{
    "success": true,
    "data": {
        "max_risk_score": 60,
        "block_signals": [
            "undeliverable",
            "placeholder",
            "vacant"
        ],
        "require_exists": false,
        "is_default": true,
        "updated_at": null
    }
}
```

## Error codes

- `UNAUTHENTICATED` — https://spaw.co/docs/errors/UNAUTHENTICATED
- `RATE_LIMITED` — https://spaw.co/docs/errors/RATE_LIMITED

---

Canonical page: https://spaw.co/docs/api/get-address-policy · OpenAPI document: https://spaw.co/openapi.json · All endpoints: https://spaw.co/docs/api