API — Portugal (PT)
20 districts, 308 municipalitys, 3,051 parishs.
Endpoints
GET
/api/v1/pt/district/{slug}.json
Single district with children
Example:
/api/v1/pt/district/acores-pt01.json
Quick Start
JavaScript
fetch('https://api.openadmindata.org/api/v1/countries/pt.json')
.then(r => r.json())
.then(data => {
const levels = data.meta.levels.map(l => l.name_en);
console.log('Portugal:', levels.join(' → '));
console.log(data.data.district.length, 'districts');
});Python
import requests
data = requests.get('https://api.openadmindata.org/api/v1/countries/pt.json').json()
districts = data['data']['district']
print(f"Portugal: {len(districts)} districts")cURL
curl -s https://api.openadmindata.org/api/v1/pt/district.json | jq '.count'Schema
Each entity record contains:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier |
name_local | string | Name in local script |
name_en | string | English / romanized name |
slug | string | URL-safe slug |
lat | number | Latitude (WGS84) |
lon | number | Longitude (WGS84) |
parent_id | string? | Parent entity ID (null for top level) |
parent_name_local | string? | Parent name in local script |
parent_name_en | string? | Parent English name |
postal_code | string? | Postal code (deepest level only, where available) |