---
title: "Get Usage Summary"
method: GET
path: "/usage/summary"
tags: ["Usage"]
---

# Get Usage Summary

`GET /usage/summary`

Returns credit usage for the active billing scope. Team owners and billing members receive team-wide usage by default; other team members receive their own usage.

## Query parameters

- `start` string, date-time — Inclusive ISO 8601 start timestamp. Defaults to seven days ago.
- `end` string, date-time — Exclusive ISO 8601 end timestamp. Defaults to the current time.
- `userId` string — Filter usage by user. Team owners and billing members may select any team member; other callers may select only themselves.

## Response `200`

Response for status 200

- UsageSummary
  - `object` 'usage_summary', required — Object type identifier.
  - `range` object, required — Time range covered by the response.
    - `start` string, date-time, required — Inclusive ISO 8601 start timestamp.
    - `end` string, date-time, required — Exclusive ISO 8601 end timestamp.
  - `scope` object, required — Authorized billing scope used for this response.
    - `id` string, required — Billing scope identifier.
    - `type` 'team' | 'personal', required — Billing scope type.
    - `isTeamWide` boolean, required — Whether the response includes usage for the entire team.
    - `userId` string — User attribution applied to the response, when filtered.
  - `credits` object, required — Credits consumed during the selected range.
    - `plan` number, required — Credits consumed from included plan credits.
    - `onDemand` number, required — Credits consumed from on-demand credits.
    - `total` number, required — Total credits consumed.
  - `daily` object[], required — Daily credit totals in chronological order.
    - `date` string, required — UTC date in YYYY-MM-DD format.
    - `credits` object, required — Credits consumed during the selected range.
      - `plan` number, required — Credits consumed from included plan credits.
      - `onDemand` number, required — Credits consumed from on-demand credits.
      - `total` number, required — Total credits consumed.
  - `dataAsOf` string, date-time — Timestamp of the reporting snapshot backing this response.

## Other responses

- `401` — Response for status 401
- `403` — Response for status 403
- `422` — Response for status 422
- `429` — Response for status 429
- `500` — Response for status 500

---

[API](https://skmtc.net/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.net/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/7c7a496f8022/schema)