---
title: "Get enriched credit ledger"
method: GET
path: "/billing/credits/ledger"
tags: ["credits"]
---

# Get enriched credit ledger

`GET /billing/credits/ledger`

## Query parameters

- `company_id` string, required
- `billing_credit_id` string
- `feature_id` string
- `period` 'daily' | 'monthly' | 'raw' | 'weekly', required
- `start_time` string
- `end_time` string
- `limit` integer — Page limit (default 100)
- `offset` integer — Page offset (default 0)

## Response `200`

OK

- object
  - `data` CreditLedgerEnrichedEntryResponseData[], required
    - `billing_credit_auto_topup_grant_count` integer, required
    - `billing_credit_id` string, required
    - `company` CompanyLedgerResponseData
      - `id` string, required
      - `logo_url` string, nullable
      - `name` string, required
    - `company_id` string, required
    - `credit` BillingCreditLedgerResponseData
      - `description` string, nullable
      - `icon` string, nullable
      - `id` string, required
      - `name` string, required
      - `plural_name` string, nullable
      - `singular_name` string, nullable
    - `expired_grant_count` integer, required
    - `feature` FeatureLedgerResponseData
      - `description` string, nullable
      - `icon` string, nullable
      - `id` string, required
      - `name` string, required
    - `feature_id` string, nullable
    - `first_transaction_at` string, date-time, required
    - `free_grant_count` integer, required
    - `grant_count` integer, required
    - `last_transaction_at` string, date-time, required
    - `manually_zeroed_count` integer, required
    - `net_change` number, required
    - `plan_grant_count` integer, required
    - `purchased_grant_count` integer, required
    - `time_bucket` string, date-time, required
    - `total_consumed` number, required
    - `total_granted` number, required
    - `transaction_count` integer, required
    - `usage_count` integer, required
    - `zeroed_out_count` integer, required
  - `params` object, required — Input parameters
    - `billing_credit_id` string
    - `company_id` string
    - `end_time` string
    - `feature_id` string
    - `limit` integer — Page limit (default 100)
    - `offset` integer — Page offset (default 0)
    - `period` 'daily' | 'monthly' | 'raw' | 'weekly'
    - `start_time` string

## Other responses

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

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) · [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/schematichq/schematic-api/revisions/96d06fa89a73/schema)