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

# List Reports

Returns a paginated list of report objects. Results are sorted by creation date, with the most recent reports first.

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.chargeapi.co/v1/reports \
    -H "Authorization: Bearer ch_sk_test_..." \
    -d status=pending \
    -d limit=10
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "data": [
          {
              "id": "rpt_pmvPjgaYmrCkk5ZpijdHUsKxeAe8ZlJu",
              "object": "report",
              "account": "acct_FxzwvKCzrlLEzOFsBXTUcD8olLuLb3qI",
              "created": "2026-05-02T00:44:48.904Z",
              "fleet": "flt_Za99zoTOnups7KDvySHSXzATBQ86E91B",
              "parameters": {
                  "filters": {
                      "vehicle": ["veh_SZ7BwCEFF2JsgwmxbvvBmCJUKHa6jmLN"]
                  },
                  "group_by": "vehicle",
                  "period_end": "2026-05-02T00:44:40.825Z",
                  "period_start": "2026-04-01T00:44:23.896Z",
                  "type": "charging_summary"
              },
              "size": 0,
              "status": "pending",
              "succeeded_at": null,
              "type": "csv",
              "url": null
          }
      ],
      "next_page_url": "https://api.chargeapi.co/v1/reports?page=page_XtZ5qLR3nykqX3aFIK0Kx4ldZJJAlX94uYqGX4BAeR0&status=pending&limit=10",
      "previous_page_url": null
  }
  ```
</ResponseExample>

## Parameters

<ParamField query="limit" type="integer">
  Maximum number of objects to return (default 10).
</ParamField>

<ParamField query="page" type="string">
  Page token from a previous list response.
</ParamField>

<ParamField query="status" type="string">
  Filter results by report status.

  Available options: `pending`, `succeeded`, `failed`
</ParamField>

## Returns

Returns a page of reports.

<ResponseField name="data" type="array of object" required>
  Array of report objects.
</ResponseField>

<ResponseField name="next_page_url" type="string | null" required>
  URL for the next page of results, or `null` when there is no next page.
</ResponseField>

<ResponseField name="previous_page_url" type="string | null" required>
  URL for the previous page of results, or `null` when there is no previous page.
</ResponseField>