Boncourant Simulate API
The Simulate API from Boncourant — 2 operation(s) for simulate.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/boncourant-fr:boncourant-fr-simulate-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Boncourant — calculs publics et études temporaires Simulate…
version: 1.5.1
description: Sans compte. Les arguments sont validés par les mêmes handlers que le serveur MCP. Les études temporaires nécessitent leur reçu secret.
servers:
- url: https://boncourant.fr
tags:
- name: Simulate
paths:
/api/simulate:
post:
operationId: simulateResidential
summary: Estimation résidentielle sur le catalogue actuel, sans compte
security: []
requestBody:
required: true
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
postal_code:
type: string
pattern: ^\d{5}$
puissance_kva:
type: number
exclusiveMinimum: 0
maximum: 36
conso_annuelle_kwh:
type: number
exclusiveMinimum: 0
maximum: 1000000
option:
type: string
enum:
- Base
- HP/HC
- Tempo
proportion_hc:
type: number
minimum: 0
maximum: 1
required:
- postal_code
- puissance_kva
- conso_annuelle_kwh
additionalProperties: false
allOf:
- if:
required:
- option
properties:
option:
const: HP/HC
then:
required:
- proportion_hc
else:
not:
required:
- proportion_hc
responses:
'200':
description: Résultat calculé, ou grounded=false sans montant inventé. Données privées, jamais mises en cache.
content:
application/json:
schema:
oneOf:
- type: object
required:
- grounded
- reason
- generated_at
properties:
grounded:
const: false
reason:
type: string
generated_at:
type: string
- type: object
required:
- grounded
- recommendation
- best_offer_annual_eur
- trv_annual_eur
- saving_eur
- offers_compared
- generated_at
properties:
grounded:
const: true
recommendation:
enum:
- stay
- switch
offers_compared:
type:
- number
- 'null'
confidence:
type:
- number
- 'null'
calculation_status:
enum:
- verified
- estimated
- needs_confirmation
- null
assumptions:
type: array
items: {}
uncertainties:
type: array
items:
type: string
provenance:
type:
- object
- 'null'
simulator_version:
type: string
catalog_version:
type: string
generated_at:
type: string
format: date-time
postal_code:
type: string
puissance_kva:
type: number
conso_annuelle_kwh:
type: number
option:
type: string
best_offer_annual_eur:
type:
- number
- 'null'
trv_annual_eur:
type:
- number
- 'null'
saving_eur:
type:
- number
- 'null'
best_offer_name:
type: string
best_offer_supplier:
type: string
'400':
description: Arguments invalides ou incohérents
'413':
description: Requête supérieure à 16 Ko
'415':
description: Content-Type application/json requis
'429':
description: Limite par instance atteinte ; respecter Retry-After
'503':
description: Calcul indisponible
tags:
- Simulate
/api/simulate/pro:
post:
operationId: estimateC5Base
summary: Estimation C5 Base Enedis, sans référence TRVe ni économie personnelle supposée
security: []
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
required:
- conso_annuelle_kwh
- puissance_kva
- dso
- option
properties:
conso_annuelle_kwh:
type: number
exclusiveMinimum: 0
maximum: 1000000
puissance_kva:
type: integer
minimum: 3
maximum: 36
dso:
const: enedis
option:
const: Base
responses:
'200':
description: Résultat calculé, ou grounded=false sans montant inventé. Données privées, jamais mises en cache.
content:
application/json:
schema:
type: object
required:
- grounded
- best
- offers_compared
- saving_eur
- note
properties:
grounded:
type: boolean
offers_compared:
type: integer
best:
type:
- object
- 'null'
properties:
name:
type: string
supplier:
type: string
annual_eur:
type: number
subscription_eur:
type: number
energy_eur:
type: number
observed_at:
type: string
format: date-time
baseline_annual_eur:
type: 'null'
saving_eur:
type: 'null'
note:
type: string
'400':
description: Arguments invalides ou incohérents
'413':
description: Requête supérieure à 16 Ko
'415':
description: Content-Type application/json requis
'429':
description: Limite par instance atteinte ; respecter Retry-After
'503':
description: Calcul indisponible
tags:
- Simulate
externalDocs:
url: https://boncourant.fr/agents