Skip to main content
POST
/
v1
/
poa
Proof of Address API
curl --request POST \
  --url https://identity.contra.id/v1/poa

​
Request

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
  }'
BodyTypeRequiredDescription
document_imagestringyesBase64-encoded JPEG/PNG/PDF.
expected_namestringrecommendedTriggers name-match warning if different.
countryISO-2recommendedFor geocoding + issuer validation.
max_age_daysintegernoReject documents older than N days (default 90).

​
Response · 200

{
  "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.