> ## 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 Event object

<div className="xl:hidden">
  <CodeGroup>
    ```json The Event object theme={null}
    {
        "id": "evt_NmNUTThiOjk3oAzDtQpWLV79AFhr78FT",
        "object": "event",
        "api_version": "2026-03-01",
        "created": "2026-05-02T00:15:38.499Z",
        "data": {
            "object": {
                "id": "rpt_cXNADyjylti5TA9JtivLG8LoGAVCXXGn",
                "object": "report",
                "account": "acct_djHdeh3hqtozOcRPwM9waEvEDlt8aIOf",
                "created": "2026-05-02T00:10:54.165Z",
                "fleet": "flt_jtLY9FGZyEKTgbjpHAgAEhAGpSWAcDSa",
                "parameters": {
                    "filters": {
                        "vehicle": ["veh_cMgLbPyKOE8S6znGcN0Sfif38u1VkqSi"]
                    },
                    "group_by": "vehicle",
                    "period_end": "2026-05-02T00:10:49.695Z",
                    "period_start": "2026-04-01T00:11:03.047Z",
                    "type": "charging_summary"
                },
                "size": 48312,
                "status": "succeeded",
                "succeeded_at": "2026-05-02T00:16:14.012Z",
                "type": "csv",
                "url": "https://files.chargeapi.co/reports/rpt_cXNADyjylti5TA9JtivLG8LoGAVCXXGn.csv"
            },
            "previous_attributes": {
                "status": "processing"
            }
        },
        "livemode": false,
        "pending_webhooks": 1,
        "request": {
            "id": "req_EyT9KDgAXspoANAnxvmjQPlMoqclRg3j",
            "idempotency_key": "idem_6Qu8Ct9AyKLiCftseJA9vuu6a7Wq6NAI"
        },
        "type": "report.succeeded"
    }
    ```
  </CodeGroup>
</div>

<div className="hidden xl:block">
  <ResponseExample>
    ```json The Event object theme={null}
    {
        "id": "evt_NmNUTThiOjk3oAzDtQpWLV79AFhr78FT",
        "object": "event",
        "api_version": "2026-03-01",
        "created": "2026-05-02T00:15:38.499Z",
        "data": {
            "object": {
                "id": "rpt_cXNADyjylti5TA9JtivLG8LoGAVCXXGn",
                "object": "report",
                "account": "acct_djHdeh3hqtozOcRPwM9waEvEDlt8aIOf",
                "created": "2026-05-02T00:10:54.165Z",
                "fleet": "flt_jtLY9FGZyEKTgbjpHAgAEhAGpSWAcDSa",
                "parameters": {
                    "filters": {
                        "vehicle": ["veh_cMgLbPyKOE8S6znGcN0Sfif38u1VkqSi"]
                    },
                    "group_by": "vehicle",
                    "period_end": "2026-05-02T00:10:49.695Z",
                    "period_start": "2026-04-01T00:11:03.047Z",
                    "type": "charging_summary"
                },
                "size": 48312,
                "status": "succeeded",
                "succeeded_at": "2026-05-02T00:16:14.012Z",
                "type": "csv",
                "url": "https://files.chargeapi.co/reports/rpt_cXNADyjylti5TA9JtivLG8LoGAVCXXGn.csv"
            },
            "previous_attributes": {
                "status": "processing"
            }
        },
        "livemode": false,
        "pending_webhooks": 1,
        "request": {
            "id": "req_EyT9KDgAXspoANAnxvmjQPlMoqclRg3j",
            "idempotency_key": "idem_6Qu8Ct9AyKLiCftseJA9vuu6a7Wq6NAI"
        },
        "type": "report.succeeded"
    }
    ```
  </ResponseExample>
</div>

This object represents a webhook event in Charge. Events are immutable snapshots of resource changes that Charge delivers to your webhook endpoints.

## Attributes

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

<ResponseField name="api_version" type="string | null">
  API version used to render `data` when this event was created.
</ResponseField>

<ResponseField name="data" type="object" required>
  Object containing the resource snapshot for the event.

  <Expandable title="properties">
    <ResponseField name="object" type="object" required>
      Resource snapshot relevant to the event.
    </ResponseField>

    <ResponseField name="previous_attributes" type="object | null">
      Object containing the previous values of fields that changed.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="request" type="object | null">
  Information about the API request that triggered the event, if any.

  <Expandable title="properties">
    <ResponseField name="id" type="string | null">
      ID of the API request that caused the event.
    </ResponseField>

    <ResponseField name="idempotency_key" type="string | null">
      Idempotency key transmitted with the originating request, if any.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="type" type="string" required>
  Type of the event.

  Available options: `charge.succeeded`, `report.succeeded`
</ResponseField>

## More attributes

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

  Available options: `event`
</ResponseField>

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

<ResponseField name="livemode" type="boolean" required>
  Indicates whether the event was generated in live or test mode.
</ResponseField>

<ResponseField name="pending_webhooks" type="integer" required>
  Number of webhook endpoints that have not yet acknowledged this event.
</ResponseField>
