{"info":{"name":"PlotFinder — Jurisdiction API","description":"The full chain of administrative authority over any coordinate, parcel or place in South Africa: province, district and local municipality, ward, registration division and Deeds Office of jurisdiction — who rates it, who services it, where to file.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"item":[{"name":"jurisdiction","item":[{"name":"The full chain of administrative authority at a point","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/at","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","at"],"query":[{"key":"lat","value":"","description":"Latitude, -90..90","disabled":true},{"key":"lon","value":"","description":"Longitude, -180..180","disabled":true},{"key":"as_at","value":"","description":"Resolve as at this date (YYYY-MM-DD)","disabled":true}]},"description":"Who rates and taxes this property, who services it, which ward covers it, where to file: province, district municipality, local municipality, ward, registration division, Deeds Office of jurisdiction and township, resolved from one coordinate. Each link carries its code, name and vintage."}},{"name":"The chain for a land parcel, by LPI","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/parcel/{lpi}","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","parcel","{lpi}"],"query":[{"key":"as_at","value":"","description":"Resolve as at this date (YYYY-MM-DD)","disabled":true}]},"description":"The same chain as /at, resolved from the parcel's label point — with an explicit note when the parcel's boundary straddles an administrative boundary, and which boundaries it crosses."}},{"name":"The chain for up to 5,000 coordinates in one call","request":{"method":"POST","header":[{"key":"X-API-KEY","value":"{{apiKey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/batch","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","batch"],"query":[]},"description":"Bulk-tag a customer database with municipality and ward: POST {\"points\": [{\"latitude\": …, \"longitude\": …}, …]} and results come back in input order — null where a point lies outside South Africa's demarcated area.","body":{"mode":"raw","raw":"{}"}}},{"name":"List boundaries of a type","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/boundaries/{boundary_type}","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","boundaries","{boundary_type}"],"query":[{"key":"province","value":"","description":"Family code, e.g. GP","disabled":true},{"key":"municipality","value":"","description":"Parent municipality code, e.g. CPT","disabled":true},{"key":"parent","value":"","description":"Parent code at any level","disabled":true},{"key":"as_at","value":"","description":"","disabled":true},{"key":"limit","value":"","description":"","disabled":true},{"key":"cursor","value":"","description":"","disabled":true}]},"description":"List boundaries of a type"}},{"name":"One boundary, with attributes","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/boundaries/{boundary_type}/{code}","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","boundaries","{boundary_type}","{code}"],"query":[{"key":"as_at","value":"","description":"","disabled":true}]},"description":"One boundary, with attributes"}},{"name":"A boundary's polygon","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/boundaries/{boundary_type}/{code}/geometry","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","boundaries","{boundary_type}","{code}","geometry"],"query":[{"key":"format","value":"","description":"","disabled":true},{"key":"simplify","value":"","description":"metres","disabled":true},{"key":"as_at","value":"","description":"","disabled":true}]},"description":"A boundary's polygon"}},{"name":"The boundaries one level down","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/boundaries/{boundary_type}/{code}/children","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","boundaries","{boundary_type}","{code}","children"],"query":[{"key":"as_at","value":"","description":"","disabled":true}]},"description":"Wards in a municipality, municipalities in a district, districts in a province."}},{"name":"Fuzzy name search across all boundary types","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/search","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","search"],"query":[{"key":"q","value":"","description":"","disabled":false},{"key":"types","value":"","description":"comma list; default all","disabled":true},{"key":"as_at","value":"","description":"","disabled":true},{"key":"limit","value":"","description":"","disabled":true}]},"description":"Trigram-matched: \"Overstrand\", \"Ward 42 Ekurhuleni\", \"Bloemfontein\"."}},{"name":"Layer vintages, counts and known gaps","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/coverage","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","coverage"],"query":[]},"description":"Layer vintages, counts and known gaps"}},{"name":"Coverage-map data: administrative boundaries for a viewport","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/heatmap","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","heatmap"],"query":[{"key":"north","value":"","description":"","disabled":true},{"key":"south","value":"","description":"","disabled":true},{"key":"east","value":"","description":"","disabled":true},{"key":"west","value":"","description":"","disabled":true},{"key":"types","value":"","description":"comma list; default the municipal chain","disabled":true}]},"description":"Drives coverage maps, including the PlotFinder admin panel's Jurisdiction layer. Always geometry (the whole set is small): province, district and municipal outlines at any span, wards and townships scale-gated the way every family map layer behaves."}},{"name":"Administrative overlay vector tiles","request":{"method":"GET","header":[{"key":"X-API-KEY","value":"{{apiKey}}"}],"url":{"raw":"{{baseUrl}}/api/v1/jurisdiction/tiles/{z}/{x}/{y}.mvt","host":["{{baseUrl}}"],"path":["api","v1","jurisdiction","tiles","{z}","{x}","{y}.mvt"],"query":[{"key":"layers","value":"","description":"","disabled":true}]},"description":"Administrative overlay vector tiles"}}]}],"variable":[{"key":"baseUrl","value":"https://api.starlightsoftware.co.bw"},{"key":"apiKey","value":"YOUR_API_KEY_HERE"}]}