Skip to main content
curl -X POST https://api.chargeapi.co/v1/reports \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "parameters": {
    "period_end": "2026-05-02T00:17:49.442Z",
    "period_start": "2026-04-01T00:18:06.932Z",
    "type": "charging_summary"
  }
}'

{
    "id": "rpt_kryMLRtfr8HJYs7xUm2lA2MS3pe8RzR9",
    "object": "report",
    "account": "acct_7XRI8yvnFHeUxJTZyrEHZpvbeoXHAPcn",
    "created": "2026-05-02T00:18:03.609Z",
    "fleet": "flt_QP37STtAqG1IDAy6Dd6Qwpy2L2jq8rUC",
    "parameters": {
        "filters": {
            "vehicle": ["veh_hMbjoAIhToYAb14hkjgjEHDwJ4eT0Q3c"]
        },
        "group_by": "vehicle",
        "period_end": "2026-05-02T00:17:49.442Z",
        "period_start": "2026-04-01T00:18:06.932Z",
        "type": "charging_summary"
    },
    "size": 0,
    "status": "pending",
    "succeeded_at": null,
    "type": "csv",
    "url": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.chargeapi.co/llms.txt

Use this file to discover all available pages before exploring further.

Creates a report. Report generation is asynchronous. The initial response returns a report object with status set to pending. Retrieve the report later or listen for report.succeeded to know when the file is ready. 
curl -X POST https://api.chargeapi.co/v1/reports \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "parameters": {
    "period_end": "2026-05-02T00:17:49.442Z",
    "period_start": "2026-04-01T00:18:06.932Z",
    "type": "charging_summary"
  }
}'

{
    "id": "rpt_kryMLRtfr8HJYs7xUm2lA2MS3pe8RzR9",
    "object": "report",
    "account": "acct_7XRI8yvnFHeUxJTZyrEHZpvbeoXHAPcn",
    "created": "2026-05-02T00:18:03.609Z",
    "fleet": "flt_QP37STtAqG1IDAy6Dd6Qwpy2L2jq8rUC",
    "parameters": {
        "filters": {
            "vehicle": ["veh_hMbjoAIhToYAb14hkjgjEHDwJ4eT0Q3c"]
        },
        "group_by": "vehicle",
        "period_end": "2026-05-02T00:17:49.442Z",
        "period_start": "2026-04-01T00:18:06.932Z",
        "type": "charging_summary"
    },
    "size": 0,
    "status": "pending",
    "succeeded_at": null,
    "type": "csv",
    "url": null
}

​
Parameters

​
fleet
string
Limit the report to a single fleet.
​
parameters
object
Report configuration payload.

​
Returns

Returns the created report.