API — South Sudan (SS)
10 states, 79 countys, 512 payams.
Endpoints
GET
/api/v1/ss/state/{slug}.json
Single state with children
Quick Start
JavaScript
fetch('https://openadmindata.org/api/v1/countries/ss.json')
.then(r => r.json())
.then(data => {
const levels = data.meta.levels.map(l => l.name_en);
console.log('South Sudan:', levels.join(' → '));
console.log(data.data.state.length, 'states');
});Python
import requests
data = requests.get('https://openadmindata.org/api/v1/countries/ss.json').json()
states = data['data']['state']
print(f"South Sudan: {len(states)} states")cURL
curl -s https://openadmindata.org/api/v1/ss/state.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) |