API · v1

API Lotissements MCLU

Accès programmatique aux données des lotissements de Côte d'Ivoire, consolidées depuis le Ministère de la Construction, du Logement et de l'Urbanisme (MCLU). L'accès requiert une clé Capital Foncier valide, délivrée sur autorisation écrite.

Authentification requise

L'accès à cette API est réservé aux partenaires autorisés. Chaque requête doit présenter une clé Capital Foncier valide dans l'en-tête Authorization: Bearer cf_lot_…. La clé est délivrée par Capital Foncier après autorisation écrite — volumes, conditions et durée définis au cas par cas. Sans clé valide, l'API renvoie une erreur 401.

Formulaire de contact

Service en pause pour les nouvelles demandes : les endpoints renvoient une réponse 503 aux requêtes sans clé. Les clés actives restent fonctionnelles.

4 000+ lotissements

Couvrant 1965 à aujourd'hui, mis à jour chaque semaine

Accès authentifié

Clé Capital Foncier (Bearer) requise sur chaque requête

Quota par clé

Quota mensuel + limite anti-burst, suivi par clé

Endpoints

GET/api/public/v1/lotissements

Liste paginée avec filtres.

Query parameters

commune	string	Filtre exact (insensitive)
statut	enum	APPROUVE \| ANNULE \| EN_SURSIS \| EN_INSTANCE \| INCONNU
q	string	Recherche full-text sur nom + commune
page	number	1-500 (défaut 1)
pageSize	number	1-100 (défaut 50)

Exemple

curl -H "Authorization: Bearer cf_lot_VOTRE_CLE" "https://www.capital-foncier.com/api/public/v1/lotissements?commune=Cocody&statut=APPROUVE&pageSize=10"

GET/api/public/v1/lotissements/[slug]

Détail d'un lotissement avec historique des changements de statut.

Query parameters

slug

string

Identifiant URL-safe (ex: 'riviera-palmeraie-2019-cocody')

Exemple

curl -H "Authorization: Bearer cf_lot_VOTRE_CLE" "https://www.capital-foncier.com/api/public/v1/lotissements/riviera-palmeraie-2019-cocody"

GET/api/public/v1/lotissements.csv

Export CSV complet (jusqu'à 10 000 lignes), filtres identiques à la liste JSON. UTF-8 BOM pour Excel.

Query parameters

commune	string	Filtre exact (insensitive)
statut	enum	APPROUVE \| ANNULE \| EN_SURSIS \| EN_INSTANCE \| INCONNU
q	string	Recherche full-text sur nom + commune

Exemple

curl -H "Authorization: Bearer cf_lot_VOTRE_CLE" -O "https://www.capital-foncier.com/api/public/v1/lotissements.csv?commune=COCODY&statut=APPROUVE"

Format de réponse

Toutes les réponses sont au format JSON et incluent une section attribution citant la source primaire (MCLU).

{
  "api": { "version": "v1", "endpoint": "lotissements" },
  "attribution": {
    "primarySource": "Ministère de la Construction... (MCLU)",
    "primaryUrl": "https://construction.gouv.ci/mclulotissement",
    "publisher": "Capital Foncier",
    "license": "Données publiques. Attribution requise pour réutilisation.",
    "lastSync": "2026-04-25T03:00:00.000Z"
  },
  "pagination": { "page": 1, "pageSize": 50, "total": 4044, "totalPages": 81 },
  "filters": { "commune": null, "statut": null, "q": null },
  "data": [
    {
      "id": "ckxxxxx",
      "slug": "riviera-palmeraie-2019-cocody",
      "nom": "RIVIERA PALMERAIE",
      "commune": "COCODY",
      "departement": "ABIDJAN",
      "annee": 2019,
      "statut": "APPROUVE",
      "arreteReference": "117/MCU/DUA du 15/03/2019",
      "arreteDate": "2019-03-15T00:00:00.000Z",
      "url": "https://www.capital-foncier.com/outils/lotissements/riviera-palmeraie-2019-cocody"
    }
  ]
}

Attribution obligatoire

Si vous réutilisez ces données, vous devez créditer à la fois la source primaire (MCLU) et l'éditeur (Capital Foncier). Exemple :

Source: MCLU (construction.gouv.ci/mclulotissement)
Éditeur: Capital Foncier (capital-foncier.com)

Authentification

Présentez votre clé dans l'en-tête HTTP Authorization: Bearer cf_lot_…à chaque requête. Une clé peut être restreinte à une liste d'adresses IP et dispose d'un quota mensuel.

401 — clé absente, invalide, révoquée ou expirée
403 — adresse IP source non autorisée pour cette clé
429 — quota mensuel dépassé, ou limite anti-burst atteinte (header Retry-After)

Limites

Quota mensuel par clé, défini à la délivrance et suivi en temps réel
Limite anti-burst par clé : liste 60 req/min, détail 120 req/min, export CSV 10 req/min
En cas de dépassement : HTTP 429 + header Retry-After: 60
Headers retournés à chaque requête : X-RateLimit-Remaining, X-RateLimit-Reset

Besoin d'un accès ou d'un quota plus large ?

Pour ouvrir un accès (collectivités, bureaux d'études, agences immobilières) ou augmenter le quota mensuel de votre clé, contactez l'équipe pour définir les conditions.

Contacter l'équipe