APIs › Kurdish, Arabic & Text Utilities › Iraqi Address Structuring

Iraqi Address Structuring

Parses free-text Iraqi and Kurdistan Region addresses into governorate, district, locality, street and landmark components with per-field confidence.

POST /v1/text/iraqi-address-structure $0.02 per call

Specification

Endpoint

POST /v1/text/iraqi-address-structure

Price

$0.02 per call · tier advanced_analysis

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Deterministic local computation on caller-supplied text

Timeout

15 seconds

Max request

1 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/text/iraqi-address-structure" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "governorate": {
    "value": "Erbil",
    "matched": "أربيل",
    "confidence": 0.95
  },
  "components": {
    "mahalla": {
      "value": "308",
      "keyword": "محلة",
      "confidence": 0.85
    },
    "street": {
      "value": "60",
      "keyword": "شارع",
      "confidence": 0.85
    },
    "alley": {
      "value": "12",
      "keyword": "زقاق",
      "confidence": 0.85
    },
    "building": {
      "value": "5",
      "keyword": "بناية",
      "confidence": 0.85
    },
    "landmark": {
      "value": "مول ماجدي",
      "keyword": "قرب",
      "confidence": 0.6
    }
  },
  "component_count": 5,
  "overall_confidence": 0.83,
  "unparsed_remainder": "",
  "note": "Iraqi addresses generally do not use a postcode in practice. Location is expressed as governorate → district → mahalla → alley → building, often anchored to a landmark."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints