Algeria Administrative Divisions

Name: Algeria Administrative Divisions
Creator: GeoAlgeria
License: https://opensource.org/licenses/MIT

geoalgeria

69 wilayas, 555 dairas, 1,528 communes — bilingual names, postal codes, coordinates, plus 3,908 post offices and 2,026 ATMs.

6,086 records across 7 datasetsnpm

Source: ONS, Algerie Poste, ANEM, Journal Officiel

Install

npm install geoalgeria

Quick example

import dz from "geoalgeria";

const wilayas = dz.wilayas;           // 69 wilayas
const alger = dz.getWilaya(16);       // single wilaya
const communes = dz.getCommunesByWilaya(16);

API reference

Name	Signature	Description
`wilayas`	`readonly wilayas: Wilaya[]`	All 69 wilayas (lazy-loaded).
`communes`	`readonly communes: Commune[]`	All 1,528 communes (lazy-loaded).
`dairas`	`readonly dairas: Daira[]`	All 555 dairas (lazy-loaded).
`ecommerce`	`readonly ecommerce: CommuneEcommerce[]`	Flat denormalized commune list for e-commerce use.
`all`	`readonly all: WilayaWithCommunes[]`	69 wilayas with nested communes.
`postOffices`	`readonly postOffices: PostOffice[]`	All 3,908 post offices (mirrored from @geoalgeria/poste).
`atms`	`readonly atms: Atm[]`	All 2,026 ATMs (mirrored from @geoalgeria/poste).
`getWilaya`	`getWilaya(code: number): Wilaya \| undefined`	Look up a single wilaya by its numeric code.
`getCommunesByWilaya`	`getCommunesByWilaya(wilayaCode: number): Commune[]`	All communes in a wilaya.
`getDairasByWilaya`	`getDairasByWilaya(wilayaCode: number): Daira[]`	All dairas in a wilaya.
`findCommune`	`findCommune(name: string): Commune[]`	Fuzzy search communes by French or Arabic name.
`findByPostalCode`	`findByPostalCode(postalCode: string): Commune[]`	Find communes by exact postal code.
`getPostOfficesByCommune`	`getPostOfficesByCommune(codeCommune: number \| string): PostOffice[]`	Post offices in a commune (by commune code).

Record shape

Field	Type	Nullable	Description
`code`	`number`	—	Wilaya numeric code (1-69).
`name_fr`	`string`	—	Wilaya name in French.
`name_ar`	`string`	—	Wilaya name in Arabic.
`phone_code`	`string`	yes	Phone area code.
`postal_code`	`string`	—	Primary postal code.
`latitude`	`number`	—	Latitude (WGS84).
`longitude`	`number`	—	Longitude (WGS84).
`created`	`"original" \| "2019" \| "2025"`	—	Which administrative reform created this wilaya.
`parent_wilaya`	`string`	yes	Parent wilaya for wilayas created post-reform.

Formats

JSONCSVGEOJSONSQLTS

The npm package ships JSON. Other formats are available in each GitHub Release.

Related packages

@geoalgeria/poste

3,908 post offices and 2,026 ATMs from Algerie Poste — real postal codes, bilingual names, coordinates, commune/wilaya linkage.

@geoalgeria/emploi

331 public employment agencies (58 AWEM + 273 ALEM) from ANEM — addresses, contacts, GPS coordinates.

@geoalgeria/banques

21 banks and 8 financial institutions (Banque d'Algerie list) plus 1,704 branch locations across all 21 banks.

View on npm All packages