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

# Proof of Address API

> Verify a utility bill, bank statement, or government letter — OCR extraction + geocoding + name match.

## Request

```bash theme={null}
curl -X POST https://identity.contra.id/v1/poa \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "document_image": "data:image/jpeg;base64,/9j/4AAQ…",
    "expected_name":  "Mikayla Halvorson",
    "country":        "GB",
    "max_age_days":   90
  }'
```

| Body             | Type    | Required    | Description                                        |
| ---------------- | ------- | ----------- | -------------------------------------------------- |
| `document_image` | string  | **yes**     | Base64-encoded JPEG/PNG/PDF.                       |
| `expected_name`  | string  | recommended | Triggers name-match warning if different.          |
| `country`        | ISO-2   | recommended | For geocoding + issuer validation.                 |
| `max_age_days`   | integer | no          | Reject documents older than N days *(default 90)*. |

## Response · 200

```json theme={null}
{
  "poa_id": "poa_4ac8…",
  "status": "passed",
  "extracted": {
    "name":      "Mikayla Halvorson",
    "address":   "12 Downing St, London SW1A 2AA, UK",
    "issuer":    "British Gas",
    "issued_at": "2026-04-12"
  },
  "checks": {
    "name_match":   "passed",
    "geocode":      "passed",
    "freshness":    "passed",
    "tamper_score": 0.04
  }
}
```

**Global coverage** — utility bills, bank statements, council/tax letters across 220+ countries.