---
title: "List usage records"
method: GET
path: "/v1/connect/usage"
---

# List usage records

`GET /v1/connect/usage`

Retrieve Connect usage records for a time window

## Query parameters

- `start_ts` integer, required
- `end_ts` integer, required

## Response `200`

usage records listed

- ConnectUsageResponse — Connect usage records for a time window
  - `data` ConnectUsage[], required
    - `credits_used` integer, required — Total Connect credits used
    - `action_run_credits_used` integer, nullable — Credits used when running Connect actions
    - `proxy_credits_used` integer, nullable — Credits used by Connect proxy requests
    - `source_emit_credits_used` integer, nullable — Credits used by Connect source event emissions
    - `usage_start_ts` integer, required — Usage window start timestamp (seconds)
    - `usage_end_ts` integer, required — Usage window end timestamp (seconds)

## Other responses

- `400` — invalid timestamps
- `429` — too many requests

---

[API](https://skmtc.net/pipedream/apis/pipedream-rest-api.md) · [All operations](https://skmtc.net/pipedream/apis/pipedream-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipedream/pipedream-rest-api/revisions/c25dbf225c49/schema)