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

# Get credit spend policy

`GET /billing/credits/spend-policies/{spend_policy_id}`

## Request

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

## Path parameters

- `spend_policy_id` string, required

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

## Other responses

- `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/window_unit/allOf[#/components/schemas/CreditSpendWindowUnit]/` response property for the response status `200`
  - added the new `week` enum value to the `data/window_unit/allOf[#/components/schemas/CreditSpendWindowUnit]/` response property for the response status `200`
- **2026-10-05** `bd39f70605e4`: 6 info
  - added the optional property `data/consumed` to the response with the `200` status
  - added the optional property `data/headroom` to the response with the `200` status
  - added the optional property `data/resets_at` to the response with the `200` status
  - added the optional property `data/window_amount` to the response with the `200` status
  - …2 more
- **2026-09-02** `3d18f4ee08ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/schematichq/apis/schematic-api/changes/billing/credits/spend-policies/:spend_policy_id/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)