Search the post offices and ATMs
Post offices (or ATMs with kind=atm) by name, postal code, commune, wilaya or distance from a place (lat, lng, radius_km). Algeria only.
Request
- Base URL: https://www.upgrowth.dz/api/v1
- URL: https://www.upgrowth.dz/api/v1/post-offices
- Auth: one of:
- none
- HTTP bearer
Query parameters
post_office (default) or atm.
Words of the name or the address, accents ignored.
A postal code, or its first digits (16 for every code of wilaya 16).
A four-digit commune code.
A wilaya number from 1 to 69, or the slug of a wilaya created in 2026.
Latitude of the place to search around, with lng.
Longitude of the place to search around, with lat.
Search radius around lat and lng, in km (10 by default).
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.