This page contains comprehensive examples of API requests and responses with real data to help you integrate with the Market Data API effectively.
Request:
{
"meta": {
"clientId": "market-research-corp",
"productTier": "pro"
},
"area": {
"type": "RADIUS",
"centerPoint": [13.405, 52.52],
"radiusInMeter": 1500
},
"skip": 0,
"limit": 2
}
Response:
{
"data": [
{
"address": {
"city": "Berlin",
"countryCode": "DEU",
"streetName": "Parkstraße 19",
"zip": "10178"
},
"chargePoints": [
{
"evseId": "DE*EVS*E05061",
"maxPower": 11.0,
"monthlyMetrics": {
"2024-09": {
"averageSessionDuration": 9958,
"consumption": {
"confidenceRange": {
"max": 853.225,
"min": 739.245
},
"estimation": 796.235
},
"sessionCount": 53,
"utilisation": 0.204
},
"2024-10": {
"averageSessionDuration": 8587,
"consumption": {
"confidenceRange": {
"max": 518.956,
"min": 433.032
},
"estimation": 475.994
},
"sessionCount": 34,
"utilisation": 0.109
},
"2024-11": {
"averageSessionDuration": 13645,
"consumption": {
"confidenceRange": {
"max": 1119.091,
"min": 975.141
},
"estimation": 1047.116
},
"sessionCount": 62,
"utilisation": 0.326
},
"2024-12": {
"averageSessionDuration": 8031,
"consumption": {
"confidenceRange": {
"max": 740.523,
"min": 638.776
},
"estimation": 689.65
},
"sessionCount": 50,
"utilisation": 0.15
},
"2025-01": {
"averageSessionDuration": 8828,
"consumption": {
"confidenceRange": {
"max": 583.083,
"min": 489.323
},
"estimation": 536.203
},
"sessionCount": 38,
"utilisation": 0.125
},
"2025-02": {
"averageSessionDuration": 0,
"consumption": {
"confidenceRange": {
"max": 0.0,
"min": 0.0
},
"estimation": 0.0
},
"sessionCount": 0,
"utilisation": 0.0
},
"2025-03": {
"averageSessionDuration": 7064,
"consumption": {
"confidenceRange": {
"max": 621.14,
"min": 530.848
},
"estimation": 575.994
},
"sessionCount": 44,
"utilisation": 0.116
},
"2025-04": {
"averageSessionDuration": 9927,
"consumption": {
"confidenceRange": {
"max": 809.353,
"min": 693.293
},
"estimation": 751.323
},
"sessionCount": 50,
"utilisation": 0.192
},
"2025-05": {
"averageSessionDuration": 6551,
"consumption": {
"confidenceRange": {
"max": 971.354,
"min": 850.535
},
"estimation": 910.944
},
"sessionCount": 67,
"utilisation": 0.164
},
"2025-06": {
"averageSessionDuration": 6558,
"consumption": {
"confidenceRange": {
"max": 983.456,
"min": 859.654
},
"estimation": 921.555
},
"sessionCount": 66,
"utilisation": 0.167
},
"2025-07": {
"averageSessionDuration": 7500,
"consumption": {
"confidenceRange": {
"max": 593.874,
"min": 495.124
},
"estimation": 544.499
},
"sessionCount": 36,
"utilisation": 0.101
},
"2025-08": {
"averageSessionDuration": 0,
"consumption": {
"confidenceRange": {
"max": 0.0,
"min": 0.0
},
"estimation": 0.0
},
"sessionCount": 0,
"utilisation": 0.0
}
},
"weekdayMetrics": {
"fri": {
"averageSessionDuration": 7298,
"averageUtilisation": 0.169,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 424.883,
"min": 342.556
},
"estimation": 383.72
},
"sessionCount": 26
},
"mon": {
"averageSessionDuration": 6002,
"averageUtilisation": 0.139,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 384.135,
"min": 310.468
},
"estimation": 347.301
},
"sessionCount": 26
},
"sat": {
"averageSessionDuration": 6627,
"averageUtilisation": 0.177,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 466.619,
"min": 381.959
},
"estimation": 424.289
},
"sessionCount": 30
},
"sun": {
"averageSessionDuration": 7037,
"averageUtilisation": 0.088,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 223.886,
"min": 166.641
},
"estimation": 195.263
},
"sessionCount": 14
},
"thu": {
"averageSessionDuration": 6105,
"averageUtilisation": 0.13,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 366.627,
"min": 294.968
},
"estimation": 330.798
},
"sessionCount": 24
},
"tue": {
"averageSessionDuration": 6362,
"averageUtilisation": 0.136,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 373.988,
"min": 299.664
},
"estimation": 336.826
},
"sessionCount": 24
},
"wed": {
"averageSessionDuration": 8184,
"averageUtilisation": 0.175,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 390.128,
"min": 310.768
},
"estimation": 350.448
},
"sessionCount": 24
}
}
},
{
"evseId": "DE*EGS*E02856",
"maxPower": 11.0,
"monthlyMetrics": {
"2024-09": {
"averageSessionDuration": 11480,
"consumption": {
"confidenceRange": {
"max": 1041.402,
"min": 906.829
},
"estimation": 974.116
},
"sessionCount": 62,
"utilisation": 0.275
},
"2024-10": {
"averageSessionDuration": 9957,
"consumption": {
"confidenceRange": {
"max": 470.475,
"min": 384.735
},
"estimation": 427.605
},
"sessionCount": 29,
"utilisation": 0.108
},
"2024-11": {
"averageSessionDuration": 10723,
"consumption": {
"confidenceRange": {
"max": 1121.696,
"min": 985.505
},
"estimation": 1053.601
},
"sessionCount": 69,
"utilisation": 0.285
},
"2024-12": {
"averageSessionDuration": 9103,
"consumption": {
"confidenceRange": {
"max": 861.682,
"min": 746.632
},
"estimation": 804.157
},
"sessionCount": 56,
"utilisation": 0.19
},
"2025-01": {
"averageSessionDuration": 8224,
"consumption": {
"confidenceRange": {
"max": 608.747,
"min": 516.162
},
"estimation": 562.454
},
"sessionCount": 40,
"utilisation": 0.123
},
"2025-02": {
"averageSessionDuration": 0,
"consumption": {
"confidenceRange": {
"max": 0.0,
"min": 0.0
},
"estimation": 0.0
},
"sessionCount": 0,
"utilisation": 0.0
},
"2025-03": {
"averageSessionDuration": 5526,
"consumption": {
"confidenceRange": {
"max": 780.463,
"min": 682.933
},
"estimation": 731.698
},
"sessionCount": 59,
"utilisation": 0.122
},
"2025-04": {
"averageSessionDuration": 8275,
"consumption": {
"confidenceRange": {
"max": 831.122,
"min": 714.595
},
"estimation": 772.859
},
"sessionCount": 54,
"utilisation": 0.172
},
"2025-05": {
"averageSessionDuration": 9360,
"consumption": {
"confidenceRange": {
"max": 934.841,
"min": 804.333
},
"estimation": 869.587
},
"sessionCount": 54,
"utilisation": 0.189
},
"2025-06": {
"averageSessionDuration": 9588,
"consumption": {
"confidenceRange": {
"max": 1028.142,
"min": 888.762
},
"estimation": 958.452
},
"sessionCount": 57,
"utilisation": 0.211
},
"2025-07": {
"averageSessionDuration": 9190,
"consumption": {
"confidenceRange": {
"max": 779.508,
"min": 660.4
},
"estimation": 719.954
},
"sessionCount": 44,
"utilisation": 0.151
},
"2025-08": {
"averageSessionDuration": 0,
"consumption": {
"confidenceRange": {
"max": 0.0,
"min": 0.0
},
"estimation": 0.0
},
"sessionCount": 0,
"utilisation": 0.0
}
},
"weekdayMetrics": {
"fri": {
"averageSessionDuration": 8559,
"averageUtilisation": 0.206,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 459.099,
"min": 370.156
},
"estimation": 414.627
},
"sessionCount": 27
},
"mon": {
"averageSessionDuration": 8157,
"averageUtilisation": 0.131,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 302.5,
"min": 233.36
},
"estimation": 267.93
},
"sessionCount": 18
},
"sat": {
"averageSessionDuration": 9340,
"averageUtilisation": 0.183,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 432.855,
"min": 343.389
},
"estimation": 388.122
},
"sessionCount": 22
},
"sun": {
"averageSessionDuration": 15445,
"averageUtilisation": 0.179,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 335.41,
"min": 250.352
},
"estimation": 292.881
},
"sessionCount": 13
},
"thu": {
"averageSessionDuration": 8344,
"averageUtilisation": 0.201,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 485.147,
"min": 393.591
},
"estimation": 439.369
},
"sessionCount": 27
},
"tue": {
"averageSessionDuration": 9963,
"averageUtilisation": 0.204,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 411.976,
"min": 325.338
},
"estimation": 368.657
},
"sessionCount": 23
},
"wed": {
"averageSessionDuration": 8708,
"averageUtilisation": 0.194,
"estimatedTotalConsumption": {
"confidenceRange": {
"max": 417.72,
"min": 335.092
},
"estimation": 376.406
},
"sessionCount": 25
}
}
}
],
"location": [
13.42342,
52.52027
],
"operatorName": "Example Charging Solutions"
}
],
"hasMore": true,
"total": 4404
}
Request:
{
"boundary": {
"countryCode": "DEU"
},
"period": {
"year": 2024,
"month": 10
},
"skip": 0,
"limit": 2
}
JSON Response:
{
"data": [
{
"operatorName": "Example Charging Solutions",
"address": {
"streetName": "Ringstraße 130",
"zip": "12683",
"city": "Berlin",
"countryCode": "DEU"
},
"location": [
13.55663,
52.5123
],
"chargePoints": [
{
"maxPower": 0.0,
"evseId": "DEU*CTS*E06774",
"monthlyMetrics": {
"averageSessionDuration": 0,
"consumption": {
"estimation": 0.0,
"confidenceRange": {
"min": 0.0,
"max": 0.0
}
},
"sessionCount": 0,
"utilisation": 0.0
}
}
]
},
{
"operatorName": "Example Charging Solutions",
"address": {
"streetName": "Schillerstraße 143",
"zip": "01257",
"city": "Dresden",
"countryCode": "DEU"
},
"location": [
13.82856,
50.99915
],
"chargePoints": [
{
"maxPower": 22.0,
"evseId": "DEU*CPE*E07508",
"monthlyMetrics": {
"averageSessionDuration": 10582,
"consumption": {
"estimation": 276.299,
"confidenceRange": {
"min": 242.942,
"max": 309.657
}
},
"sessionCount": 18,
"utilisation": 0.071
}
},
{
"maxPower": 22.0,
"evseId": "DEU*PFE*E02324",
"monthlyMetrics": {
"averageSessionDuration": 14342,
"consumption": {
"estimation": 172.891,
"confidenceRange": {
"min": 143.461,
"max": 202.322
}
},
"sessionCount": 10,
"utilisation": 0.054
}
},
{
"maxPower": 22.0,
"evseId": "DEU*CTS*E09762",
"monthlyMetrics": {
"averageSessionDuration": 8307,
"consumption": {
"estimation": 166.057,
"confidenceRange": {
"min": 141.672,
"max": 190.443
}
},
"sessionCount": 12,
"utilisation": 0.037
}
},
{
"maxPower": 22.0,
"evseId": "DEU*GCN*E09078",
"monthlyMetrics": {
"averageSessionDuration": 17462,
"consumption": {
"estimation": 202.103,
"confidenceRange": {
"min": 167.176,
"max": 237.03
}
},
"sessionCount": 11,
"utilisation": 0.072
}
}
]
}
]
}
Request:
{
"boundary": {
"countryCode": "FRA"
},
"period": {
"year": 2024,
"month": 9
},
"powerSpecification": {
"type": "AC",
"powerRangeKw": {
"min": 7,
"max": 22
}
},
"skip": 0,
"limit": 25
}
CSV Response: