---
title: "Count company grants"
method: GET
path: "/billing/credits/grants/company/count"
tags: ["credits"]
---

# Count company grants

`GET /billing/credits/grants/company/count`

## Request

- Base URL: `https://api.schematichq.com`
- URL: `https://api.schematichq.com/billing/credits/grants/company/count`
- Auth: API key in header `X-Schematic-Api-Key`

## Query parameters

- `company_id` string, required
- `order` 'created_at' | 'expires_at' | 'quantity' | 'quantity_remaining'
- `dir` 'asc' | 'desc'
- `limit` integer: Page limit (default 100)
- `offset` integer: Page offset (default 0)

## Response `200`

OK

- object
  - `data` CountResponse, required
    - `count` integer: The number of resources
  - `params` object, required: Input parameters
    - `company_id` string
    - `dir` 'asc' | 'desc'
    - `limit` integer: Page limit (default 100)
    - `offset` integer: Page offset (default 0)
    - `order` 'created_at' | 'expires_at' | 'quantity' | 'quantity_remaining'

## Other responses

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

## Changes

> 230 revisions in range; 1 not diffed.

- **2026-08-18** `9057f42cad5d`: 1 breaking
  - the `query` request parameter `company_id` became required
- **2026-07-15** `3baa54bf8b3f`: 2 warning
  - for the `query` request parameter `limit`, the max was set to `250.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`

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