Skip to main content
GET
/
v1
/
contracts
/
{contractId}
/
credits
/
ledger
Get Credit Ledger
curl --request GET \
  --url https://api.monk.com/v1/contracts/{contractId}/credits/ledger \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "totalCount": 4,
    "entries": [
      {
        "id": "entry-usage-1",
        "type": "usage",
        "amountCents": -2500,
        "creditAmount": -250,
        "creditRateCents": 10,
        "currency": "USD",
        "description": "Usage for INV-24548 (LLM tokens)",
        "sourceType": "invoice",
        "invoiceId": "inv-24548",
        "grantEntryId": "entry-grant-1",
        "expiresAt": null,
        "isPromotional": false,
        "createdAt": "2026-03-03T10:54:00.000Z"
      },
      {
        "id": "entry-grant-2",
        "type": "grant",
        "amountCents": 5000,
        "creditAmount": 500,
        "creditRateCents": 10,
        "currency": "USD",
        "description": "Bonus credit grant from contract creation",
        "sourceType": "contract",
        "invoiceId": null,
        "grantEntryId": null,
        "expiresAt": "2026-06-12T23:59:59.000Z",
        "isPromotional": true,
        "createdAt": "2026-02-27T06:41:00.000Z"
      },
      {
        "id": "entry-grant-1",
        "type": "grant",
        "amountCents": 20000,
        "creditAmount": 2000,
        "creditRateCents": 10,
        "currency": "USD",
        "description": "Initial prepaid credit grant from contract creation",
        "sourceType": "contract",
        "invoiceId": null,
        "grantEntryId": null,
        "expiresAt": "2026-06-12T23:59:59.000Z",
        "isPromotional": false,
        "createdAt": "2026-02-27T06:41:00.000Z"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.monk.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns all credit ledger entries sorted by createdAt descending (newest first). Returns empty entries if no credit wallet exists. Entry Types:
TypeDescriptionamountCents
grantCredits added to walletPositive
usageCredits consumed (applied to invoice)Negative
adjustmentManual correction to balancePositive or negative
reversalUndo a previous entryOpposite of original
expirationCredits expired (breakage)Negative
FIFO Tracking: Each usage and expiration entry includes a grantEntryId linking it to the source grant for audit trails. Scope: contracts:read

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
contractId
string
required

The unique identifier of the contract (UUID)

Response

Credit ledger entries

​
data
object

Credit ledger entries response