POST
/
reports
curl --request POST \
  --url https://api.chargeapi.co/v1/reports
{
  "id": null,
  "object": null,
  "account": null,
  "created": null,
  "fleet": null,
  "parameters": {
    "filters": {
      "vehicle": null
    },
    "group_by": null,
    "period_start": null,
    "period_end": null,
    "type": null
  },
  "size": null,
  "status": null,
  "succeeded_at": null,
  "type": null,
  "url": null
}

Response

200 - application/json
A newly created report.

A Report represents an exported summary of charging activity, usage metrics, or cost breakdowns over a given time period. Reports can be filtered, grouped, and downloaded in CSV or other supported formats.

​
id
string

Unique identifier for the report object.

Example:

null

​
object
string

String representing the object’s type. Always reporting.

Example:

null

​
account
string

ID of the account associated with this report.

Example:

null

​
created
integer

Time at which the report was created.

Example:

null

​
fleet
string

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

Example:

null

​
parameters
object

Parameters used to generate the report.

​
size
integer

Size of the generated report file in bytes.

Example:

null

​
status
enum<string>

Current status of the report generation process.

Available options:
pending,
processing,
succeeded,
failed
Example:

null

​
succeeded_at
integer

Timestamp when the report generation was completed successfully.

Example:

null

​
type
string

File format of the generated report (e.g., csv, pdf).

Example:

null

​
url
string

Public URL to download the generated report file.

Example:

null