Population/API v2

Pauvreté multidimensionnelle par territoire

GET/api/v2/population/poverty

À savoir. RGPH 2024 et séries historiques HCP. Consultez meta pour la source et la date de chaque série.

Comprendre le contexte

RGPH est le recensement de la population réalisé par le HCP, l’office statistique marocain. Un résident n’est pas nécessairement de nationalité marocaine. Exemple de lecture : 100 résidents, dont 95 Marocains et 5 étrangers, donnent un total de 100 ; ne les additionnez pas une seconde fois. Cet exemple est illustratif.

Paramètres

levelstringFacultatif · Filtre

Niveau territorial, par exemple regions ou communes.

Par défaut: regions

areastringFacultatif · Filtre

Milieu de résidence : all (ensemble), urban ou rural.

Par défaut: all

yearintegerFacultatif · Filtre

Année sur 4 chiffres.

Par défaut: 2024

region_codestringFacultatif · Filtre

Code MoroccoAPI de la région.

2-80 caractères

Format

^[a-z0-9]+(?:-+[a-z0-9]+)*$

province_codestringFacultatif · Filtre

Code MoroccoAPI de la province ou préfecture.

2-180 caractères

Format

^[a-z0-9]+(?:-+[a-z0-9]+)*$

limitintegerFacultatif · Filtre

Résultats par page. 100 par défaut, 500 maximum.

Minimum: 1Maximum: 500Par défaut: 100

offsetintegerFacultatif · Filtre

Résultats à ignorer après filtrage. Commence à 0.

Minimum: 0Maximum: 2147483647Par défaut: 0

Comprendre la réponse

data: Les résultats demandés, sous forme d’objet ou de liste.

meta: Sources, licence et dates du jeu de données. null signifie une valeur inconnue ou indisponible.

meta.pagination: Listes : 100 résultats par défaut, 500 maximum. Utilisez limit et offset ; meta.pagination.next_offset vaut null à la dernière page.

Exemple illustratif: Avec limit=10 et offset=0, la première page contient au plus 10 résultats. Si next_offset vaut 10, demandez la suivante avec offset=10 et les mêmes filtres. Arrêtez quand next_offset vaut null.

API v2 est le chemin de référence. Les anciens chemins /api/v1 restent des alias de compatibilité du comportement actuellement publié, pagination comprise ; aucune date de suppression n’est fixée.

Champs renvoyés 29

[] désigne chaque élément d’une liste. null signifie inconnu ou indisponible, jamais zéro. La langue du guide ne traduit pas les valeurs des sources.

dataobject[]

Résultat demandé : objet unique ou liste.

data[].levelstring

Niveau territorial : national, regions, subdivisions (provinces et préfectures), prefectures-of-arrondissements, communes ou arrondissements.

Valeurs acceptées: "national" "regions" "subdivisions" "prefectures-of-arrondissements" "communes" "arrondissements"

data[].codestring | null

Identifiant MoroccoAPI de la ressource ; réutilisez-le dans les URL correspondantes.

data[].hcp_codestring | null

Code du Haut-Commissariat au Plan (office statistique marocain). Conservez-le comme texte pour garder les zéros initiaux.

data[].nameobject

Nom de la ressource, éventuellement réparti par langue.

data[].name.arstring

Valeur en arabe ; null si aucune traduction n’est fournie.

data[].name.frstring

Valeur en français ; null si aucune traduction n’est fournie.

data[].name.enstring | null

Valeur en anglais ; null si aucune traduction n’est fournie.

data[].region_codestring | null

Identifiant de la région parente, premier niveau administratif du Maroc.

data[].province_codestring | null

Identifiant de la province ou préfecture parente, sous la région.

data[].areastring

Milieu de résidence : all (urbain et rural ensemble), urban ou rural.

Valeurs acceptées: "all" "urban" "rural"

data[].yearnumber

Année à laquelle se rapporte l’observation, pas l’année de téléchargement.

Valeurs acceptées: 2024 2014

data[].mpinumber | null

Indice de pauvreté multidimensionnelle (MPI = H × A), entre 0 et 1 ; null quand personne n’est pauvre.

data[].poverty_ratenumber | null

Taux de pauvreté (H) : pourcentage de la population en pauvreté multidimensionnelle.

data[].poverty_intensitynumber | null

Intensité (A) : part moyenne des privations subies par les pauvres, en pourcentage ; null quand personne n’est pauvre.

data[].vulnerability_ratenumber | null

Pourcentage de la population vulnérable à la pauvreté multidimensionnelle.

data[].deprivation_ratesobject

Pourcentage de la population privée pour chacun des dix indicateurs de l’indice.

data[].deprivation_rates.child_mortalitynumber | null

Pourcentage de la population privée : mortalité infantile (santé).

data[].deprivation_rates.disabilitynumber | null

Pourcentage de la population privée : handicap (santé).

data[].deprivation_rates.school_attendancenumber | null

Pourcentage de la population privée : scolarisation des enfants (éducation).

data[].deprivation_rates.years_of_schoolingnumber | null

Pourcentage de la population privée : nombre d’années de scolarité (éducation).

data[].deprivation_rates.electricitynumber | null

Pourcentage de la population privée : électricité (conditions de vie).

data[].deprivation_rates.waternumber | null

Pourcentage de la population privée : eau (conditions de vie).

data[].deprivation_rates.sanitationnumber | null

Pourcentage de la population privée : assainissement (conditions de vie).

data[].deprivation_rates.housingnumber | null

Pourcentage de la population privée : logement (conditions de vie).

data[].deprivation_rates.cooking_fuelnumber | null

Pourcentage de la population privée : mode de cuisson (conditions de vie).

data[].deprivation_rates.communication_assetsnumber | null

Pourcentage de la population privée : moyens de communication (actifs).

data[].mpi_trendstring | null

Lecture HCP de l’évolution du MPI entre 2014 et 2024 : decrease, increase, stagnation ou new_urban_centre ; null pour 2014.

data[].aligned_with_dakhlaboolean

true pour les valeurs 2014 de quatre communes alignées par le HCP sur la commune de Dakhla, en raison de la mobilité saisonnière lors du recensement.

Structure des données

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "level",
          "code",
          "hcp_code",
          "name",
          "region_code",
          "province_code",
          "area",
          "year",
          "mpi",
          "poverty_rate",
          "poverty_intensity",
          "vulnerability_rate",
          "deprivation_rates",
          "mpi_trend",
          "aligned_with_dakhla"
        ],
        "properties": {
          "level": {
            "enum": [
              "national",
              "regions",
              "subdivisions",
              "prefectures-of-arrondissements",
              "communes",
              "arrondissements"
            ]
          },
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "MoroccoAPI geography code; null for the national total."
          },
          "hcp_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "HCP geographic code in the dotted form used by the geography endpoints; null for the national total."
          },
          "name": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "ar",
              "fr",
              "en"
            ],
            "properties": {
              "ar": {
                "type": "string"
              },
              "fr": {
                "type": "string"
              },
              "en": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              }
            }
          },
          "region_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ]
          },
          "province_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ]
          },
          "area": {
            "enum": [
              "all",
              "urban",
              "rural"
            ],
            "description": "all (urban and rural together), urban or rural."
          },
          "year": {
            "enum": [
              2024,
              2014
            ],
            "description": "Census year: 2024, or 2014 as revised by HCP for comparison."
          },
          "mpi": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0,
                "maximum": 1
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Multidimensional poverty index (MPI = H × A), between 0 and 1. HCP leaves it empty (null) when no one is poor."
          },
          "poverty_rate": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "H: percentage of the population in multidimensional poverty."
          },
          "poverty_intensity": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "A: average share of deprivations among poor people, in percent. Null when no one is poor."
          },
          "vulnerability_rate": {
            "anyOf": [
              {
                "type": "number",
                "minimum": 0,
                "maximum": 100
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Percentage of the population vulnerable to multidimensional poverty."
          },
          "deprivation_rates": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "child_mortality",
              "disability",
              "school_attendance",
              "years_of_schooling",
              "electricity",
              "water",
              "sanitation",
              "housing",
              "cooking_fuel",
              "communication_assets"
            ],
            "description": "Percentage of the population deprived in each of the ten indicators.",
            "properties": {
              "child_mortality": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "disability": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "school_attendance": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "years_of_schooling": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "electricity": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "water": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "sanitation": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "housing": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "cooking_fuel": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              },
              "communication_assets": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  {
                    "type": "string",
                    "nullable": true,
                    "enum": [
                      null
                    ]
                  }
                ]
              }
            }
          },
          "mpi_trend": {
            "anyOf": [
              {
                "enum": [
                  "decrease",
                  "increase",
                  "stagnation",
                  "new_urban_centre"
                ]
              },
              {
                "type": "string",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "HCP's reading of the MPI change between 2014 and 2024, on 2024 observations only; null on 2014 observations."
          },
          "aligned_with_dakhla": {
            "type": "boolean",
            "description": "True for the 2014 values of four communes that HCP aligned on the commune of Dakhla because of seasonal mobility during the 2014 census."
          }
        }
      }
    },
    "meta": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dataset",
        "total",
        "license",
        "retrieved_at",
        "transformation_version",
        "sources",
        "pagination"
      ],
      "properties": {
        "dataset": {
          "enum": [
            "population-poverty"
          ]
        },
        "total": {
          "type": "integer",
          "minimum": 0
        },
        "license": {
          "enum": [
            "CC-BY-4.0"
          ]
        },
        "retrieved_at": {
          "enum": [
            "2026-10-26"
          ]
        },
        "transformation_version": {
          "enum": [
            "1.0.0"
          ]
        },
        "sources": {
          "type": "array",
          "minItems": 1,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "dataset",
              "producer",
              "source_url",
              "resource_url",
              "license",
              "source_updated_at"
            ],
            "properties": {
              "dataset": {
                "type": "string"
              },
              "producer": {
                "type": "string"
              },
              "source_url": {
                "type": "string",
                "format": "uri"
              },
              "resource_url": {
                "type": "string",
                "format": "uri"
              },
              "license": {
                "enum": [
                  "CC-BY-4.0"
                ]
              },
              "source_updated_at": {
                "type": "string",
                "format": "date"
              }
            }
          }
        },
        "pagination": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "limit",
            "offset",
            "count",
            "has_more",
            "next_offset"
          ],
          "properties": {
            "limit": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            },
            "offset": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            },
            "count": {
              "type": "integer",
              "minimum": 0,
              "maximum": 500
            },
            "has_more": {
              "type": "boolean"
            },
            "next_offset": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2147483647
                },
                {
                  "type": "string",
                  "nullable": true,
                  "enum": [
                    null
                  ]
                }
              ]
            }
          }
        }
      }
    }
  }
}

Sources et pagination 19

metaobject

Contexte du résultat : sources, dates, licence et pagination si applicable.

meta.datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

Valeurs acceptées: "population-poverty"

meta.totalinteger

Nombre de résultats correspondant aux filtres, avant pagination ; pas la taille de cette page.

meta.licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "CC-BY-4.0"

meta.retrieved_atstring

Date de récupération du fichier source par le projet ; pas la date des observations.

Valeurs acceptées: "2026-10-26"

meta.transformation_versionstring

Version des règles de conversion du jeu de données ; distincte de l’API.

Valeurs acceptées: "1.0.0"

meta.sourcesobject[]

Sources utilisées pour ce résultat, avec leurs producteurs et licences.

meta.sources[].datasetstring

Nom du jeu de données auquel appartient le résultat ou la source.

meta.sources[].producerstring

Organisme qui publie la donnée originale.

meta.sources[].source_urlstring

Page de présentation ou de publication de la source.

meta.sources[].resource_urlstring

Lien vers le fichier ou la ressource utilisée.

meta.sources[].licensestring

Licence de réutilisation. mixed signifie des licences différentes : consultez chaque source.

Valeurs acceptées: "CC-BY-4.0"

meta.sources[].source_updated_atstring

Dernière mise à jour annoncée par la source ; pas la date de récupération.

meta.paginationobject

Informations pour parcourir une collection page par page.

meta.pagination.limitinteger

Nombre maximal demandé par page : 100 par défaut, 500 au maximum.

meta.pagination.offsetinteger

Nombre de résultats ignorés avant cette page, après filtrage. La première page commence à 0.

meta.pagination.countinteger

Nombre de résultats effectivement présents dans cette page.

meta.pagination.has_moreboolean

true s’il reste une autre page de résultats.

meta.pagination.next_offsetinteger | null

Valeur de offset pour la page suivante ; null à la fin. Gardez les mêmes filtres.

Erreurs

400: Paramètre invalide ou manquant.

Les erreurs renvoient error.code, error.message et error.request_id.

errorobject: Détails d’une requête échouée ; remplace data et meta.
error.codestring: Code stable de l’erreur, par exemple RESOURCE_NOT_FOUND ; à utiliser dans votre logique.
error.messagestring: Explication lisible de l’erreur ; utilisez code pour la logique de votre application.
error.request_idstring: Identifiant du traitement de cette requête, utile pour retrouver un problème.

Pauvreté multidimensionnelle par territoire

Paramètres

Votre requête