Enedis API (1.0.0)

Download OpenAPI specification:Download

A Propos

Cette API permet de récupérer les données de consommation, de production, ainsi que les donnéees techniques et contractuelles d'un consommateur et/ou producteur d'électricité. L'utilisation de cette API est soumise au recueil préalable du consontement de l'utilisateur par Enedis. Pour se faire, veuillez-vous rendre sur cette page

Authentification

L'utilisation de cette API nécessite un token qui vous sera fourni à l'issue du recueil de consentement. Il devra être fourni dans l'entête HTTP de tous vos appels.

Limitations

Enedis limite le nombre de requêtes par seconde envoyées par le partenaire. Par conséquent, afin de laisser la possibilité à tout le monde de récupérer ses informations, il est recommandé de ne pas effectuer de demande de données de consommation et/ou production plus d'une fois par jour, d'autant plus qu'Enedis ne les met à jour qu'une fois par jour.

Support

Si vous avez des questions, rejoignez-nous sur Discord

Récupérer les données Enedis

Cette ressource vous permet de récuperer l'ensemble des données Enedis, à savoir les données de consommation/production détaillées ou quotidienne, ainsi que les informations sur le contrat de l'utilisateur.

header Parameters
Authorization
required
string

Jeton obtenu lors du consentement

Request Body schema: application/json

Les paramètres pour récupérer les données de consommation Enedis.

type
required
string
Enum: "consumption_load_curve" "daily_consumption_max_power" "daily_consumption" "production_load_curve" "daily_production" "identity" "contracts" "addresses"

Le type de requête effectué:

  • consumption_load_curve - Retourne les données de consommation par pas de 10, 30 ou 60 minutes (30 par défaut), pour chaque jour de la période demandée. La plage demandée ne peut excéder 7 jours et sur une période de moins de 24 mois et 15 jours avant la date d'appel.
  • daily_consumption_max_power - Retourne la donnée maximale de consommation par pas de 1 jour, pour chaque jour de la période demandée. La plage demandée ne peut être que sur une période de moins de 36 mois et 15 jours avant la date d'appel.
  • daily_consumption - Retourne les données de consommation par pas de 1 jour, pour chaque jour de la période demandée. La plage demandée ne peut être que sur une période de moins de 36 mois et 15 jours avant la date d'appel.
  • production_load_curve - Retourne les données de production par pas de 10, 30 ou 60 minutes (30 par défaut), pour chaque jour de la période demandée. La plage demandée ne peut excéder 7 jours et sur une période de moins de 24 mois et 15 jours avant la date d'appel.
  • daily_production - Retourne les données de production par pas de 1 jour, pour chaque jour de la période demandée. La plage demandée ne peut être que sur une période de moins de 36 mois et 15 jours avant la date d'appel.
  • identity - Retourne l'identité du client
  • contracts - Retourne les données contractuelles
  • addresses - Retourne l'adresse du point de livraison et/ou production
usage_point_id
required
string (PDL)

L'identifiant du point de livraison ou de production

start
string (IsoDate)

Date au format full-date de la RFC 3339, à savoir YYYY-MM-DD, à utiliser uniquement avec les requêtes consommation/production.

end
string (IsoDate)

Date au format full-date de la RFC 3339, à savoir YYYY-MM-DD, à utiliser uniquement avec les requêtes consommation/production.

Responses

Request samples

Content type
application/json
{
  • "type": "consumption_load_curve",
  • "usage_point_id": 22516914714270,
  • "start": "2020-09-26T15:27:28.484Z",
  • "end": "2020-09-26T15:27:28.484Z"
}

Response samples

Content type
application/json
Example
{
  • "meter_reading":
    {
    }
}