API · v1

API Lotissements

Accès programmatique aux données des lotissements de Côte d'Ivoire, consolidées depuis le Ministère de l'Urbanisme, du Logement et du Cadre de Vie (ex-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 attributioncitant la source primaire (ministère chargé de l'Urbanisme, ex-MCLU).

{
  "api": { "version": "v1", "endpoint": "lotissements" },
  "attribution": {
    "primarySource": "Ministère de l'Urbanisme, du Logement et du Cadre de Vie (ex-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 (ministère chargé de l'Urbanisme, ex-MCLU) et l'éditeur (Capital Foncier). Exemple :

Source: Ministère chargé de l'Urbanisme (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