Préparation du dossier
Les données officielles se chargent. Le relevé s'affichera dans un instant.
Préparation du dossier
Les données officielles se chargent. Le relevé s'affichera dans un instant.
Toutes les routes demandent une clé API, incluse dans les paliers B2B. Lire le catalogue ne décompte aucune évaluation : seule la cadence est bornée. Le contrat est stable sous /v1.
Le descripteur ci-dessous est celui que sert l'API : ce que vous lisez ici est ce que vous recevrez. GET https://cbfinder.ca/v1/schema
GET /v1/programmesclé APICatalogue des programmes — liste filtrable par province et par thème. Clé API requise, cadence bornée, mise en cache privée. Ne décompte aucune évaluation.
Champs de la requête
aucun corps
Champs de la réponse
Le catalogue, une fois votre clé en main :
curl https://cbfinder.ca/v1/programmes \ -H "Authorization: Bearer $CBF_API_KEY"
L'évaluation, qui elle décompte votre quota :
curl https://cbfinder.ca/v1/eligibility \
-X POST \
-H "Authorization: Bearer $CBF_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "age": 40, "revenu_annuel": 45000, "province": "QC", "situation_familiale": "marie", "nb_enfants": 1, "enfants_ages": [ 10 ], "citoyen_canadien": true, "resident_permanent": true, "emploi_statut": "employe_temps_plein", "handicap": false }'Une clé API par firme, générée depuis le portail B2B (Portail → API). Deux environnements distincts : une clé de production (live) et une clé de test (test) — la clé de test évalue avec les mêmes règles que la production, sans jamais entamer votre quota mensuel.
Envoyez la clé dans l'en-tête Authorization au format Bearer. Si votre client HTTP ne vous laisse pas définir cet en-tête, utilisez X-API-Key :
Authorization: Bearer <clé> # — ou — X-API-Key: <clé>
Le portail est réservé aux comptes professionnels rattachés à une firme : un compte citoyen n'y a pas accès.
Quota mensuel d'évaluations, par palier B2B. Lire le catalogue ne décompte rien : sa cadence est bornée séparément, à {reads} lectures par minute et par clé. Au-delà du quota : une erreur 429, distincte de l'erreur d'authentification, remise à zéro le mois suivant.
Votre suivi manuel est disponible en JSON sous un contrat versionné : statuts choisis, montants estimés ou de référence, échéances résolues et sources. Il demande votre session — c'est votre dossier, pas une donnée publique.
GET https://cbfinder.ca/api/dashboard/integrations/suivi
Branchez un agent, un IDE ou un assistant sur CBF : il découvre les outils ci-dessous et les appelle lui-même. Le client gère le protocole, vous n'avez que l'adresse à configurer.
list_programsCatalogue des prestations canadiennes sourcées, filtrable par province et par thème. Champs bilingues (fr/en) dans la même réponse. Demande un appelant identifié ; ne décompte aucune évaluation.authentifiéget_programFiche complète d'un programme du catalogue, par identifiant stable ou par slug.authentifiécheck_eligibilityÉvalue un jeu de faits contre l'ensemble du catalogue. Estimation indicative, jamais une décision gouvernementale.clé API + quotaget_trackingVotre dossier de suivi manuel : statuts choisis, montants estimés ou de référence, échéances résolues et niveau d'urgence.session ou jetonUn client MCP ne porte pas de cookie. Pour les outils marqués « session ou jeton », créez un jeton d'accès personnel : il vous représente, n'ouvre rien de plus que votre plan, porte une échéance et se révoque à tout moment. Créer un jeton
curl https://cbfinder.ca/api/mcp \
-X POST \
-H "Authorization: Bearer $CBF_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_tracking","arguments":{}}}'Pour vérifier la connexion, sans authentification :
curl https://cbfinder.ca/api/mcp \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Chaque refus porte un code stable et une cause explicite : vous savez si vous devez corriger la requête, attendre, ou demander un accès.
VALIDATION_ERRORUn champ du corps ou des paramètres de la requête est manquant, hors domaine ou d'un type invalide. Le champ fautif est nommé dans `error.field`.NOT_FOUNDL'identifiant demandé (par ex. un programme) n'existe pas dans le catalogue.INTERNAL_ERRORErreur inattendue côté serveur. Réessayez ; si elle persiste, contactez le support.UNAUTHORIZEDLa clé API est absente, malformée, inconnue ou révoquée.QUOTA_EXCEEDEDLe quota mensuel d'évaluations du palier de la firme est épuisé. Réessayez le mois suivant (voir l'en-tête `Retry-After`) ou montez de palier.