get_credit_history
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, INTENT_SIGNALS, WEB_SCRAPING, PROSPECTOR, ENRICHMENT, EMAIL_VERIFICATION, CONTACT_UNLOCK, ADJUSTMENT, OTHER), a reason and createdAt.
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, INTENT_SIGNALS, WEB_SCRAPING, PROSPECTOR, ENRICHMENT, EMAIL_VERIFICATION, CONTACT_UNLOCK, ADJUSTMENT, OTHER), a reason and createdAt. Returns { count, hasMore, logs }. Filter by date range, website, source, operation or lead domain to answer 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
| Parameter | Type | Required | Accepts | Description |
|---|---|---|---|---|
page | integer | No | min 1 · default 1 | Page number, a whole number from 1 (default 1). Use hasMore in the result to know if there is a next page. |
limit | integer | No | 1–500 · default 100 | Rows per page, a whole number from 1 to 500 (default 100). |
from | string | No | date | Earliest date, ISO (2026-10-01; a time may follow). Default: 90 days ago. |
to | string | No | date | Latest date, ISO (2026-10-31; a time may follow). Default: now. |
websiteId | string | No | any | Only this website's rows (from list_websites). Leave out for the whole account. |
source | string | No | 9 values | Only one source category: WEBSITE_VISITOR, INTENT_SIGNALS, WEB_SCRAPING, PROSPECTOR, ENRICHMENT, EMAIL_VERIFICATION, CONTACT_UNLOCK, ADJUSTMENT or OTHER. |
operation | string | No | CHARGE, REFUND, DUPLICATE_PREVENTED | Only CHARGE (credit used), REFUND (credit given back) or DUPLICATE_PREVENTED (a repeat that cost nothing). |
domain | string | No | any | Only rows for leads from this company domain, e.g. acme.com. |
Accepted values
The exact values these fields take; anything else is refused.
source
WEBSITE_VISITOR · INTENT_SIGNALS · WEB_SCRAPING · PROSPECTOR · ENRICHMENT · EMAIL_VERIFICATION · CONTACT_UNLOCK · ADJUSTMENT · OTHER
Tool definition
What your assistant receives from tools/list:
{
"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": "integer",
"minimum": 1,
"default": 1,
"description": "Page number, a whole number from 1 (default 1). Use hasMore in the result to know if there is a next page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 100,
"description": "Rows per page, a whole number from 1 to 500 (default 100)."
},
"from": {
"type": "string",
"format": "date",
"description": "Earliest date, ISO (2026-10-01; a time may follow). Default: 90 days ago."
},
"to": {
"type": "string",
"format": "date",
"description": "Latest date, ISO (2026-10-31; a time may follow). Default: now."
},
"websiteId": {
"type": "string",
"description": "Only this website's rows (from list_websites). Leave out for the whole account."
},
"source": {
"type": "string",
"enum": [
"WEBSITE_VISITOR",
"INTENT_SIGNALS",
"WEB_SCRAPING",
"PROSPECTOR",
"ENRICHMENT",
"EMAIL_VERIFICATION",
"CONTACT_UNLOCK",
"ADJUSTMENT",
"OTHER"
],
"description": "Only one source category: WEBSITE_VISITOR, INTENT_SIGNALS, WEB_SCRAPING, PROSPECTOR, ENRICHMENT, EMAIL_VERIFICATION, CONTACT_UNLOCK, ADJUSTMENT or OTHER."
},
"operation": {
"type": "string",
"enum": [
"CHARGE",
"REFUND",
"DUPLICATE_PREVENTED"
],
"description": "Only CHARGE (credit used), REFUND (credit given back) or DUPLICATE_PREVENTED (a repeat that cost nothing)."
},
"domain": {
"type": "string",
"description": "Only rows for leads from this company domain, e.g. acme.com."
}
}
}
}get_pricing
Returns the account's prices for outreach mailboxes and sending domains: mailboxPricePerMonthUSD (and the yearly equivalent), whether custom or default pricing applies, the defaults, and the outreach starter-kit state (available now, or earned on upgrade).
get_website_credit_history
Returns the credit snapshots stored for one website: each entry has creditsLimit, creditsRemaining, creditsUsed, refreshOn and timestamps.