Billing

List credit transactions

Changed on Oct 20, 2026

Credit grants, purchases, usage, and expiries, newest first. A customer-bound key sees the account ledger. Upstream cost rows are omitted. kind filters to grant, purchase, usage, or expiry. description says what the row is. A profile enrich that did not finish or found nothing is returned as a positive grant with a description that the credits were returned. request_id is the X-Request-Id of the API or MCP call that caused the charge; for an async enrich or contact lookup it is the call that started the job, and job_id names that job. Both are null when unknown, for example on older rows.

Scope: account:read.

get/v1/billing/transactions

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/billing/transactions
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: account:read)

Query parameters

kind'grant' | 'purchase' | 'usage' | 'expiry'

Only rows of this kind.

limitinteger

How many items to return. Default 25, at most 100.

cursorstring

next_cursor from the previous response. An invalid cursor is 400 invalid_request, message Invalid cursor.

Headers

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Response

Ledger rows.

object'list' required

next_cursorstring nullable required

Pass as cursor for the next page. Null on the last page.

has_moreboolean required

Example response

{
  "data": [
    {
      "id": "led_01J0LEDGER0EXAMPLE",
      "object": "credit_transaction",
      "kind": "usage",
      "purpose": "contact_enrichment",
      "description": "Contact lookup",
      "credits": -25,
      "created_at": "2026-10-15T04:17:00.000Z",
      "api_key_id": "key_01J0KEY0EXAMPLE",
      "run_id": null,
      "customer_id": null,
      "request_id": "req_4f1c2a9b7e3d5a60",
      "job_id": "cjob_01J0CJOB0EXAMPLE"
    }
  ]
}

Changes

Oct 20, 2026ad27b35513a6 Revision changes
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status

Operation history