The Report object

{
    "id": "rpt_HmS9nyVBU8YimkBftwAwPp5bqA31LyPd",
    "object": "report",
    "account": "acct_m1fAaBjTsocSgEAaAJMkNAG4dwP13R7X",
    "created": "2026-05-02T00:37:49.915Z",
    "fleet": "flt_P8fIJXDlGlEq6KQsUDSvV7DW8OQlZxgO",
    "parameters": {
        "filters": {
            "vehicle": ["veh_ZT57dmneTYSCr4PUAMg5p0Ynr5F85vpk"]
        },
        "group_by": "vehicle",
        "period_end": "2026-05-02T00:37:39.058Z",
        "period_start": "2026-04-01T00:37:49.196Z",
        "type": "charging_summary"
    },
    "size": 48312,
    "status": "succeeded",
    "succeeded_at": "2026-05-02T00:42:20.267Z",
    "type": "csv",
    "url": "https://files.chargeapi.co/reports/rpt_HmS9nyVBU8YimkBftwAwPp5bqA31LyPd.csv"
}

{
    "id": "rpt_HmS9nyVBU8YimkBftwAwPp5bqA31LyPd",
    "object": "report",
    "account": "acct_m1fAaBjTsocSgEAaAJMkNAG4dwP13R7X",
    "created": "2026-05-02T00:37:49.915Z",
    "fleet": "flt_P8fIJXDlGlEq6KQsUDSvV7DW8OQlZxgO",
    "parameters": {
        "filters": {
            "vehicle": ["veh_ZT57dmneTYSCr4PUAMg5p0Ynr5F85vpk"]
        },
        "group_by": "vehicle",
        "period_end": "2026-05-02T00:37:39.058Z",
        "period_start": "2026-04-01T00:37:49.196Z",
        "type": "charging_summary"
    },
    "size": 48312,
    "status": "succeeded",
    "succeeded_at": "2026-05-02T00:42:20.267Z",
    "type": "csv",
    "url": "https://files.chargeapi.co/reports/rpt_HmS9nyVBU8YimkBftwAwPp5bqA31LyPd.csv"
}

This object represents a report in Charge. Reports are generated asynchronously and summarize charging activity, usage, or costs over a given period.

Attributes

string

Unique identifier for the object.

string

ID of the account associated with this report.

string

ID of the fleet that this report is scoped to, if applicable.

object

Parameters used to generate the report.

Show properties

object

Filters applied when generating the report.

Show properties

array of string

List of vehicle IDs included in the report filter.

string

Field used to group data in the report.

string

End of the reporting period (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

Start of the reporting period (inclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

string

Report type or template used.

string

Current status of the report generation process.Available options: pending, processing, succeeded, failed

string

Output format of the generated report.

string | null

Public URL to download the generated report file.

More attributes

string

String representing the object’s type.

string

Time at which the report was created. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

integer | null

Size of the generated report file in bytes.

string | null

Time when the report generation was completed successfully. RFC 3339 UTC timestamp with millisecond precision, e.g. 2026-03-03T14:05:23.789Z.

Getting Started

API Behavior

API Reference

The Report object

Attributes

More attributes

​Attributes

​More attributes

Attributes

More attributes