API B2B Foncier Facile

Accédez aux données foncières de Côte d'Ivoire en temps réel. Vérification de propriété, preuves blockchain, statistiques de marché.

Access Ivory Coast land data in real-time. Property verification, blockchain proofs, market statistics.

Commencer / Get StartedEndpoints
curl -H "X-API-Key: immo_b2b_abc..." \
  https://api.foncierfacile.ci/api/b2b/v1/land/verify/\
  FF-CI-ABJ-25-I3-L15/

{
  "trust_score": 90,
  "blockchain": {
    "anchored": "True",
    "chain": "Polygon PoS"
  }
}

Démarrage rapide / Quick Start

1
Demander une clé API / Request API key

Contactez-nous à api@foncierfacile.ci avec votre nom d'organisation et cas d'usage. / Contact us at api@foncierfacile.ci with your organization name and use case.

2
Recevoir vos credentials / Receive credentials

Vous recevez une clé API unique (immo_b2b_xxx). Stockez-la de manière sécurisée. / You receive a unique API key. Store it securely.

3
Intégrer / Integrate

Ajoutez le header X-API-Key à chaque requête. Testez avec /land/verify/. / Add the X-API-Key header to each request. Test with /land/verify/.

Authentification / Authentication

Toutes les requêtes doivent inclure votre clé API dans le header X-API-Key. / All requests must include your API key in the X-API-Key header.

# cURL
curl -H "X-API-Key: immo_b2b_your_key_here" \
  https://api.foncierfacile.ci/api/b2b/v1/land/verify/FF-CI-ABJ-25-I3-L15/

# Python
import requests
headers = {"X-API-Key": "immo_b2b_your_key_here"}
r = requests.get(f"https://api.foncierfacile.ci/api/b2b/v1/land/verify/FF-CI-ABJ-25-I3-L15/", headers=headers)

# JavaScript
const res = await fetch("https://api.foncierfacile.ci/api/b2b/v1/land/verify/FF-CI-ABJ-25-I3-L15/", {
  headers: { "X-API-Key": "immo_b2b_your_key_here" }
});
Sécurité : Ne partagez jamais votre clé API. Stockez-la dans des variables d'environnement. / Security: Never share your API key. Store it in environment variables.

Tarification / Pricing

Free
Gratuit
100/jour requêtes
  • Land verification
  • Blockchain proof
  • Market stats
Basic
500 000 FCFA/mois
1 000/jour requêtes
  • All Free features
  • Ownership history
  • Owner KYC
  • Dispute alerts
Premium
1 500 000 FCFA/mois
10 000/jour requêtes
  • All Basic features
  • Webhooks
  • Priority support
  • Batch queries
Enterprise
Sur mesure
Illimité requêtes
  • All Premium features
  • Dedicated support
  • Custom SLA
  • White-label

Référence des Endpoints / Endpoint Reference

GETVérifier une parcelle / Verify a land parcel
GET https://api.foncierfacile.ci/api/b2b/v1/land/verify/{foncier_facile_id}/

Vérification complète : statut de propriété, preuve blockchain, score de confiance. / Complete verification: ownership status, blockchain proof, trust score.

Cas d'usage : Banque vérifiant un terrain avant prêt hypothécaire. / Bank verifying land before mortgage.
Paramètres / Parameters
NomTypeInDescription
foncier_facile_idstringpathID unique Foncier Facile (ex: FF-CI-ABJ-25-I3-L15)
Réponse / Response 200 OK
{
  "foncier_facile_id": "FF-CI-ABJ-25-I3-L15",
  "lot": {
    "lot_number": "15",
    "ilot_number": "3",
    "subdivision": "Cocody Riviera Palmeraie",
    "city": "Cocody",
    "area_sqm": "500.00",
    "status": "sold"
  },
  "verification": {
    "risk_level": "low",
    "current_owner_verified": "True",
    "ownership_chain_clean": "True",
    "documents_verified": "True",
    "no_duplicate_sales": "True"
  },
  "blockchain": {
    "anchored": "True",
    "chain": "Polygon PoS",
    "tx_hash": "0x367b7e67c3c...",
    "block_number": "84454594",
    "explorer_url": "https://polygonscan.com/tx/0x367b..."
  },
  "trust_score": 90
}

Webhooks

Recevez des notifications en temps réel quand un événement se produit. / Receive real-time notifications when events occur.

land_status— Changement de statut parcelle / Land status change
ownership_transfer— Transfert de propriété / Ownership transfer
dispute_created— Nouveau litige / New dispute
blockchain_anchored— Ancrage blockchain confirmé / Blockchain anchor confirmed
// Webhook payload (POST to your URL)
{
  "event": "land_status",
  "foncier_facile_id": "FF-CI-ABJ-25-I3-L15",
  "old_status": "available",
  "new_status": "sold",
  "timestamp": "2026-03-21T14:30:00Z",
  "signature": "hmac-sha256-signature..."
}

Limites & Erreurs / Rate Limits & Errors

Codes HTTP / HTTP Codes
200Succès / Success
400Paramètre manquant / Missing parameter
401Clé API invalide / Invalid API key
404Ressource introuvable / Not found
429Quota dépassé / Rate limit exceeded
Headers de réponse / Response headers
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 2026-03-22T00:00:00Z

Prêt à intégrer ? / Ready to integrate?

Contactez notre équipe pour obtenir votre clé API. / Contact our team to get your API key.

api@foncierfacile.ci