---
title: "List company grants"
method: GET
path: "/billing/credits/grants/company/list"
tags: ["credits"]
---

# List company grants

`GET /billing/credits/grants/company/list`

## Query parameters

- `company_id` string
- `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` BillingCreditGrantResponseData[], required
    - `company_id` string, required
    - `company_name` string, required
    - `created_at` string, date-time, required
    - `credit_icon` string, nullable
    - `credit_id` string, required
    - `credit_name` string, required
    - `currency` string, nullable
    - `expires_at` string, date-time, nullable
    - `grant_reason` 'adjustment' | 'billing_credit_auto_topup' | 'free' | 'plan' | 'purchased' | 'rollover', required
    - `id` string, required
    - `plan_id` string, nullable
    - `plan_name` string, nullable
    - `price` BillingPriceResponseData
      - `currency` string, required
      - `external_price_id` string, required
      - `id` string, required
      - `interval` 'day' | 'month' | 'one-time' | 'year', required
      - `interval_count` integer, required
      - `nickname` string, nullable
      - `price` integer, required
      - `price_decimal` string, nullable
      - `provider_type` 'metronome' | 'orb' | 'schematic' | 'stripe', required
      - `scheme` 'per_unit' | 'tiered', required
    - `quantity` number, double, required
    - `quantity_remaining` number, double, required
    - `quantity_used` number, double, required
    - `renewal_enabled` boolean, required
    - `renewal_period` 'daily' | 'every_6_months' | 'monthly' | 'quarterly' | 'weekly' | 'yearly'
    - `reserved` number, double, nullable
    - `settled` number, double, nullable
    - `source_grant_id` string, nullable — For rollover grants, the ID of the source grant that this grant rolled from.
    - `source_label` string, required
    - `transfers` CreditTransferResponseData[]
      - `amount` number, double, required
      - `created_at` string, date-time, required
      - `direction` string, required
      - `id` string, required
      - `reason` string, required
      - `related_grant_id` string, required
    - `updated_at` string, date-time, required
    - `valid_from` string, date-time, nullable
    - `zeroed_out_date` string, date-time, nullable
    - `zeroed_out_reason` 'customer_archived' | 'expired' | 'integration_uninstalled' | 'license_retired' | 'manual' | 'plan_change' | 'plan_period_reset' | 'reconciled'
  - `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

---

[API](https://skmtc.net/schematichq/apis/schematic-api.md) · [All operations](https://skmtc.net/schematichq/apis/schematic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/schematichq/schematic-api/versions/419cb5147b52/schema)