{"openapi":"3.1.0","info":{"title":"Postal Code API","version":"1.0.0","description":"Resolve postal and ZIP codes to city, state and geo-coordinates for around 60 countries — and the reverse, listing all postal codes of a city. Perfect for checkout and address-form autofill, shipping, store locators and geo-targeting.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/postalcode-api","description":"oanor gateway"}],"tags":[{"name":"Postal"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["Postal"],"summary":"Location for a postal code","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"2-letter ISO country","schema":{"type":"string"},"example":"us"},{"name":"postcode","in":"query","required":true,"description":"Postal / ZIP code","schema":{"type":"string"},"example":"90210"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"places":[{"state":"California","latitude":34.0901,"longitude":-118.4065,"place_name":"Beverly Hills","state_code":"CA"}],"country":"United States","post_code":"90210","country_code":"US"},"meta":{"timestamp":"2026-05-30T04:15:36.843Z","request_id":"133755be-2944-40c1-939c-86b3d4dae267"},"status":"ok","message":"Postal code resolved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/places":{"get":{"operationId":"get_v1_places","tags":["Postal"],"summary":"Postal codes for a place","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"2-letter ISO country","schema":{"type":"string"},"example":"us"},{"name":"state","in":"query","required":true,"description":"State (US: 2-letter code)","schema":{"type":"string"},"example":"ca"},{"name":"city","in":"query","required":true,"description":"City / place name","schema":{"type":"string"},"example":"Beverly Hills"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"city":"Beverly Hills","state":"California","country":"United States","post_codes":[{"latitude":33.7866,"longitude":-118.2987,"post_code":"90209","place_name":"Beverly Hills"},{"latitude":34.0901,"longitude":-118.4065,"post_code":"90210","place_name":"Beverly Hills"},{"latitude":34.0652,"longitude":-118.383,"post_code":"90211","place_name":"Beverly Hills"},{"latitude":34.0619,"longitude":-118.3995,"post_code":"90212","place_name":"Beverly Hills"},{"latitude":33.7866,"longitude":-118.2987,"post_code":"90213","place_name":"Beverly Hills"}],"country_code":"US"},"meta":{"timestamp":"2026-05-30T04:15:37.320Z","request_id":"d58f08f8-b20e-42c2-93f0-125c5ce42465"},"status":"ok","message":"Places resolved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":5,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1200,"monthly_call_quota":75000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3900,"monthly_call_quota":400000,"rps_limit":30,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9900,"monthly_call_quota":1500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/postalcode-api"}