List the communes with their postal codes
The communes of Algeria from Algérie Poste's data, read daily: code, names, wilaya and 2026 wilaya, postal codes, counts of post offices and ATMs. Filter by wilaya and q. Algeria only.
Request
- Base URL: https://www.upgrowth.dz/api/v1
- URL: https://www.upgrowth.dz/api/v1/communes
- Auth: one of:
- none
- HTTP bearer
Query parameters
A wilaya number from 1 to 69 (16 for Alger, 59 to 69 the wilayas of 2026), or the slug of a wilaya created in 2026 (aflou, barika, el-kantara, bir-el-ater, el-aricha, ksar-chellala, ain-ouessara, messaad, ksar-el-boukhari, bou-saada, el-abiodh-sidi-cheikh).
A commune name in French or Arabic (accents ignored), or the first digits of a postal code.
Only the communes of this daïra (or Algiers circonscription administrative), by name, accents ignored.
Language of the labels, notes and attribution text in the answer: fr (French, the default), ar (Arabic) or en (English).
Maximum number of results in the page, from 1 to 100. Defaults to 20. Without an API key at most 10 rows come back.
Number of results to skip, from 0 to 10000, to read the next pages. Defaults to 0. meta.total tells how many results match. Without an API key it must be 0: a search cannot be paged.
Country of the data, an ISO 3166-1 alpha-2 code in any letter case: DZ for Algeria, the default, TN for Tunisia or MA for Morocco. Only live countries answer: list_countries shows them and their datasets. Any other country, or a dataset the country does not have (for example the activity nomenclature for Morocco), returns country_not_available. Without an API key only DZ answers: TN and MA return key_required.
Response
The data, with its meta.
Changes
No recorded changes to this operation across all 1 revision of this API.