---
title: "Get credit spend policy usage"
method: GET
path: "/billing/credits/spend-policies/usage"
tags: ["credits"]
---

# Get credit spend policy usage

`GET /billing/credits/spend-policies/usage`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/billing/credits/spend-policies/usage`
- Auth: API key in header `X-Schematic-Api-Key`

## Query parameters

- `billing_credit_id` string
- `company_id` string, required
- `user_ids` string[]

## Response `200`

OK

- object
  - `data` CreditSpendPolicyResponseData[], required
    - `billing_credit_id` string, required
    - `company_id` string, nullable: The company the policy applies in
    - `consumed` number, double, nullable: Credits spent in the current window. Set only by the usage route, and only for a window cap.
    - `created_at` string, date-time, required
    - `headroom` number, double, nullable: Credits left in the current window. Set only by the usage route, and only for a window cap.
    - `id` string, required
    - `label` string, nullable
    - `max_per_draw` number, double, nullable
    - `resets_at` string, date-time, nullable: When the current window ends. Set only by the usage route, and only for a window cap.
    - `scope_type` 'company' | 'user' | 'group', required
    - `updated_at` string, date-time, required
    - `user_id` string, nullable: For a user policy, the user whose spend in the company it limits
    - `window_amount` number, double, nullable
    - `window_count` integer, required
    - `window_unit` 'hour' | 'day' | 'week' | 'month' | 'billing_period'
  - `params` object, required: Input parameters
    - `billing_credit_id` string
    - `company_id` string
    - `user_ids` string[]

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Server error

## Changes

> 230 revisions in range; 1 not diffed.

- **2026-10-19** `a021f209a793`: 2 warning
  - added the new `month` enum value to the `data/items/window_unit/allOf[#/components/schemas/CreditSpendWindowUnit]/` response property for the response status `200`
  - added the new `week` enum value to the `data/items/window_unit/allOf[#/components/schemas/CreditSpendWindowUnit]/` response property for the response status `200`
- **2026-10-05** `bd39f70605e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/billing/credits/spend-policies/usage/get.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/schematichq/apis/schematic-api/revisions/64cb7e17c236?raw)