Quickstart

Three steps: grab an API key, make a call, parse the response. Everything else is detail.

1. Get an API key

Create a free account. The key is shown exactly once at creation — store it in a secret manager.

2. Make your first call

Every endpoint expects an Authorization: Bearer YOUR_API_KEY header. Sandbox runs at api.sandbox.posty.ro with no quota.

3. Understand the response

Responses are JSON with a request_id field on every response (success or error). Quote it whenever you open a ticket.

{
  "request_id": "req_01HXYZABC123",
  "verdict": "verified",
  "address": {
    "country": "RO",
    "county": "CJ",
    "locality": "Cluj-Napoca",
    "postal_code": "400114",
    "street": "Strada Memorandumului",
    "house_number": "28"
  },
  "confidence": 0.97
}

4. Next steps

Verify, autocomplete, look up postal codes. The rest of the docs cover each endpoint in detail.

API reference Errors Webhooks