Romanian Postal Code API
Autocomplete addresses and validate six-digit postal codes in your checkout, ERP or courier platform. One GET request, JSON response.
Address autocomplete
Type a street, city or sector and get the matching addresses and postal codes.
Strict lookup
Send a six-digit code and get every locality and street it covers.
Validation
Reject invalid formats and unknown codes before the order is placed.
Built for speed
FULLTEXT search and optimized indexes keep responses fast at scale.
Endpoints
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /api/v1/autocomplete | Address autocomplete by q, localitate, judet and numar |
| GET | /api/v1/postcode/{code} | Strict lookup for a six-digit postal code |
| GET | /api/v1/me | Your plan, limits and current usage — useful for integrations |
Example request
curl "https://cecodpostal.ro/api/v1/autocomplete?q=Ciurea%2012" \
-H "X-API-KEY: YOUR_API_KEY"{
"success": true,
"count": 1,
"data": [
{
"strada_complet": "Strada Ciurea nr. 12-T",
"cod_postal": "021926",
"localitate": "Sector 2",
"judet": "Bucuresti"
}
]
}Plans
Start free. Upgrade when you grow.
Free: 500 requests/month. Pro: 100,000 requests/month, priority support and a 99.9% uptime SLA.
FAQ
What does the API do?
It autocompletes Romanian addresses and validates six-digit postal codes. You send a street, city or code and receive a JSON response with the matching locality, county, street range and official postal code.
How do I authenticate?
Send the API key in the X-API-KEY header. You generate the key from the dashboard; it is shown only once, at creation.
Is there a free plan?
Yes. The free plan includes 500 requests per month and one API key, with no card required.