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"
      }
    ]
  }
}
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