> ## 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.

# The Report object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Report object theme={null}
    {
        "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"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Report object theme={null}
    {
        "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"
    }
    ```
  </ResponseExample>
</div>

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

## Attributes

<ResponseField name="id" type="string">
  Unique identifier for the object.
</ResponseField>

<ResponseField name="account" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the account associated with this report.
</ResponseField>

<ResponseField name="fleet" type="string" post={[<Tooltip tip="This can be expanded into an object with the expand request parameter."><a href="/expand" className="charge-expandable-label">Expandable</a></Tooltip>]}>
  ID of the fleet that this report is scoped to, if applicable.
</ResponseField>

<ResponseField name="parameters" type="object">
  Parameters used to generate the report.

  <Expandable title="properties">
    <ResponseField name="filters" type="object">
      Filters applied when generating the report.

      <Expandable title="properties">
        <ResponseField name="vehicle" type="array of string">
          List of vehicle IDs included in the report filter.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="group_by" type="string">
      Field used to group data in the report.
    </ResponseField>

    <ResponseField name="period_end" type="string">
      End of the reporting period (exclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ResponseField>

    <ResponseField name="period_start" type="string">
      Start of the reporting period (inclusive). RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
    </ResponseField>

    <ResponseField name="type" type="string">
      Report type or template used.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the report generation process.

  Available options: `pending`, `processing`, `succeeded`, `failed`
</ResponseField>

<ResponseField name="type" type="string">
  Output format of the generated report.
</ResponseField>

<ResponseField name="url" type="string | null">
  Public URL to download the generated report file.
</ResponseField>

## More attributes

<ResponseField name="object" type="string">
  String representing the object's type.
</ResponseField>

<ResponseField name="created" type="string">
  Time at which the report was created. RFC 3339 UTC timestamp with millisecond precision, e.g. `2026-03-03T14:05:23.789Z`.
</ResponseField>

<ResponseField name="size" type="integer | null">
  Size of the generated report file in bytes.
</ResponseField>

<ResponseField name="succeeded_at" type="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`.
</ResponseField>