---
title: "Get customer events"
method: GET
path: "/v1/customers/{customerId}/events"
tags: ["Events"]
---

# Get customer events

`GET /v1/customers/{customerId}/events`

Get events for a customer with optional filters.

## Path parameters

- `customerId` string, required

## Query parameters

- `workflowId` string
- `eventType` string
- `from` string, date-time
- `to` string, date-time
- `limit` integer

## Response `200`

Customer events

- object — Customer events
  - `data` object[]
    - `id` string
    - `eventType` string
    - `quantity` number
    - `units` string, nullable
    - `costUnits` number, nullable
    - `runId` string, nullable
    - `timestamp` string, date-time
  - `totals` object
    - `eventCount` integer
    - `totalQuantity` string
    - `totalCostUnits` string

## Other responses

- `401` — Unauthorized
- `404` — Customer not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)