# get_credit_history (/docs/mcp/tools/get-credit-history)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/get_credit_history.mdx. */}

**Get credit history** · Read-only

Lists the account's credit transactions from the last 90 days, newest first: each row has operation (CHARGE, REFUND or DUPLICATE_PREVENTED), amount, credits before/after, the website, the lead's domain/email, a source category (WEBSITE_VISITOR, PROSPECTOR, ENRICHMENT, EMAIL_VERIFICATION, CONTACT_UNLOCK, INTENT_SIGNALS, ADJUSTMENT, OTHER), a reason and createdAt. Returns \{ count, hasMore, logs \}. Use it to explain where credits went. For one website's per-cycle allowance snapshots use get_website_credit_history. Needs an account-level key.

| Connection | Account-owner URL or OAuth (not a team member URL) |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | `number` | No | Page number, starting at 1 (default 1). Use hasMore in the result to know if there is a next page. |
| `limit` | `number` | No | Rows per page (default 100, max 500). |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "get_credit_history",
  "title": "Get credit history",
  "annotations": {
    "title": "Get credit history",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "page": {
        "type": "number",
        "description": "Page number, starting at 1 (default 1). Use hasMore in the result to know if there is a next page."
      },
      "limit": {
        "type": "number",
        "description": "Rows per page (default 100, max 500)."
      }
    }
  }
}
```