Iran Postal Code API

About Iran postal codes

Iran uses 10-digit postal codes, though the first 5 digits identify the region and are most commonly used. Tehran codes start with 1, Isfahan with 8, Shiraz with 7. The system managed by Iran Post covers all 31 provinces with nearly 4,000 regional codes.

Local term: postal code | Regex pattern: ^.+$

API Usage Examples

curl -X POST https://postaldatapi.com/api/lookup \
  -H "Content-Type: application/json" \
  -d '{"zipcode": "00", "country": "IR", "apiKey": "YOUR_API_KEY"}'

from postaldatapi import PostalDataPI

client = PostalDataPI(api_key="YOUR_API_KEY")
result = client.lookup("00", country="IR")
print(result.place_name, result.latitude, result.longitude)

import { PostalDataPI } from 'postaldatapi';

const client = new PostalDataPI({ apiKey: 'YOUR_API_KEY' });
const result = await client.lookup('00', { country: 'IR' });
console.log(result.placeName, result.latitude, result.longitude);