Convert PDF bank statements into structured transactions, accounts, and balances.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your Bankstatemently API key (bsk_live_...). Create one at https://bankstatemently.com/developer
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Decide where an "unresolved" debit from list_outflows went (the documents' claims conflict and nothing settles them). Pass "verdict" and "transactionIds" when the user has told you; leave "verdict" out to let the AI judge decide the named rows, or every unresolved row. Returns the updated list_outflows answer.
Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD).
Where the money went, as the user said. Omit to let the judge decide.
Same range as list_outflows: which debits the returned list_outflows answer reports.
transactionId of rows as list_outflows returned them in "unresolved". Required with verdict; omit to judge every unresolved row.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Decide where an "unresolved" debit from list_outflows went (the documents' claims conflict and nothing settles them). Pass "verdict" and "transactionIds" when the user has told you; leave "verdict" out to let the AI judge decide the named rows, or every unresolved row. Returns the updated list_outflows answer.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| verdict | string | Where the money went, as the user said. Omit to let the judge decide. |
| dateRange | object | Same range as list_outflows: which debits the returned list_outflows answer reports. |
| transactionIds | array | transactionId of rows as list_outflows returned them in "unresolved". Required with verdict; omit to judge every unresolved row. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"verdict": {
"enum": [
"own-account",
"account",
"cash",
"name"
],
"type": "string",
"description": "Where the money went, as the user said. Omit to let the judge decide."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "ISO date (YYYY-MM-DD). Inclusive end of the range."
},
"from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "ISO date (YYYY-MM-DD). Inclusive start of the range."
}
},
"description": "Same range as list_outflows: which debits the returned list_outflows answer reports.",
"additionalProperties": false
},
"transactionIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "transactionId of rows as list_outflows returned them in \"unresolved\". Required with verdict; omit to judge every unresolved row."
}
}
}Decide whether ambiguous pairs from list_transfers are transfers. Pass "verdict" when the user has told you; leave it out to let the AI judge decide. Returns the updated list_transfers answer.
| Argument | Type | Description |
|---|---|---|
| pairs | array | Pairs as list_transfers returned them. Required with verdict; omit to judge every open pair. |
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| verdict | string | The user's verdict. Omit to let the judge decide. |
| amountMin | number | Same floor as list_transfers. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pairs": {
"type": "array",
"items": {
"type": "object",
"required": [
"fromTransactionId",
"toTransactionId"
],
"properties": {
"toTransactionId": {
"type": "string",
"minLength": 1,
"description": "toTransactionId, as list_transfers returned it."
},
"fromTransactionId": {
"type": "string",
"minLength": 1,
"description": "fromTransactionId, as list_transfers returned it."
}
}
},
"description": "Pairs as list_transfers returned them. Required with verdict; omit to judge every open pair."
},
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"verdict": {
"enum": [
"confirmed",
"rejected"
],
"type": "string",
"description": "The user's verdict. Omit to let the judge decide."
},
"amountMin": {
"type": "number",
"description": "Same floor as list_transfers."
}
}
}Compute a single metric (sum/average/count/max/min) over a filtered set of transactions across your converted statements. Results are per-currency — never sum across currencies yourself. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range. For "how many credits do I have" / processing quota / remaining pages, use get_credits instead — that is not a transaction.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| filter | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| metric* | string | Aggregation metric. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"metric"
],
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"filter": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"metric": {
"enum": [
"sum",
"average",
"count",
"max",
"min"
],
"type": "string",
"description": "Aggregation metric."
}
}
}Run AI transaction categorization on a previously processed document, then return its category mappings. Returns cached categories with no charge if this document was already categorized. Consumes credits (pooled per page, same rate as the categorize toggle on the website) the first time — free on every re-fetch after. Every response includes a "summary" field: use it as the single source of truth for what happened.
| Argument | Type | Description |
|---|---|---|
| document_id* | string | Document ID (from convert_statement or list_statements) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"description": "Document ID (from convert_statement or list_statements)"
}
}
}Side-by-side metric comparison for two filtered groups of transactions (e.g. one category vs another, one month vs another). Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| metric* | string | Metric for both groups. |
| filterA* | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| filterB* | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filterA",
"filterB",
"metric"
],
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"metric": {
"enum": [
"sum",
"average",
"count",
"max",
"min"
],
"type": "string",
"description": "Metric for both groups."
},
"filterA": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"filterB": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
}
}
}Convert a bank statement PDF into structured data or a spreadsheet. When the user attaches a PDF in the conversation, it arrives automatically as pdf_file — never encode it yourself. Otherwise, pass pdf_url for a public HTTPS link. If your host has no way to reference the attached file at all (no pdf_file/pdf_url equivalent), call request_upload first and pass its upload_id here instead. The base64 pdf parameter is a last resort only, for a caller with no other way to reference the file. To convert several statements in one call, pass upload_ids (the array from a single request_upload call made with count set) instead of pdf/pdf_url/pdf_file/upload_id — mutually exclusive with those four. This batch form only ADMITS each file (queues it, or reports an already-completed duplicate) and returns immediately with a compact per-file status list plus a summary — it never waits for conversion, so call get_statement per document_id once ready rather than expecting inline results here. Returns accounts, transactions, and metadata. output_format "json" (default) returns the data inline, renderable in chat. The other formats (csv, xlsx, qbo, xero) return a time-limited download link instead: present it as a normal link. Every response includes a "summary" field: use it as the single source of truth for what happened. If the conversation is not in English, translate it faithfully into the conversation language; never add details it doesn't contain. Never echo raw status values (e.g. "completed") or field names. Consumes credits (1 per page). Page limit depends on your plan.
| Argument | Type | Description |
|---|---|---|
| string | Base64-encoded PDF content — last resort only; prefer pdf_file for an attachment or pdf_url for a link | |
| pdf_url | string | HTTPS URL to fetch the PDF from |
| password | string | Password for encrypted PDFs |
| pdf_file |
Create a named memory: a scoped lens over your accounts and dates with a user-authored name, optional situation ("bookkeeping", "divorce" or "estate"), and ChatScope. Free to use — no credits consumed.
| Argument | Type | Description |
|---|---|---|
| name* | string | User-authored memory name, such as a client, case, or matter name. |
| scope* | object | The accounts/products and optional date range this memory covers. |
| situation* | any | Optional matter this memory is about: bookkeeping, divorce, estate, or null. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"situation",
"scope"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "User-authored memory name, such as a client, case, or matter name."
},
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "The accounts/products and optional date range this memory covers."
},
"situation": {
"anyOf": [
{
"enum": [
"bookkeeping",
"divorce",
"estate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional matter this memory is about: bookkeeping, divorce, estate, or null."
}
}
}Hide a failed, rejected, or cancelled document from future list_statements results. Use this only when the user asks to clear a terminal failed/rejected/cancelled conversion from their history. This is not a delete: it marks the document dismissed and leaves stored data/artifacts untouched.
| Argument | Type | Description |
|---|---|---|
| document_id* | string | Document ID from list_statements, convert_statement, or get_statement |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"document_id": {
"type": "string",
"description": "Document ID from list_statements, convert_statement, or get_statement"
}
}
}Score parsed bank statement transactions against the Bankstatemently benchmark ground truth. Accepts a statement_id (e.g. "bsb-001") or content_hash, plus your parsed transactions. Returns extraction accuracy, integrity score, and an overall score. Only statements marked published: true in the catalog can be evaluated — held-out statements return an error. transactions[].originalData is optional but strongly recommended: fetch it via get_statement with data_mode: "original" and pass it through verbatim — an absent originalData scores that transaction's raw-fidelity (parsed) dimension 0; never fabricate a value. Free to use — no credits consumed. Read the benchmark://catalog resource first to see available statements and their published status.
| Argument | Type | Description |
|---|---|---|
| accounts | array | Optional account roster for multi-account statements. Each transaction references one via accountId. |
| content_hash | string | SHA-256 hex digest of the PDF. Use statement_id instead if you know it. |
| statement_id | string | Benchmark statement ID (e.g. "bsb-001"). Preferred over content_hash. |
| transactions* | array | Parsed transactions (1-2000) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transactions"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Submission-internal handle, referenced by transactions[].accountId."
},
"name": {
"type": "string",
"description": "Verbatim printed account label."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code."
},
"accountNumber": {
"type": "string",
"description": "Verbatim printed account number — never normalized by the submitter."
}
}
},
"description": "Optional account roster for multi-account statements. Each transaction references one via accountId."
},
"content_hash": {
"type": "string",
"description": "SHA-256 hex digest of the PDF. Use statement_id instead if you know it."
},
"statement_id": {
"type": "string",
"description": "Benchmark statement ID (e.g. \"bsb-001\"). Preferred over content_hash."
},
"transactions": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"description",
"amount"
],
"properties": {
"date": {
"type": "string",
"description": "ISO 8601 date (YYYY-MM-DD)"
},
"amount": {
"type": "number",
"description": "Transaction amount. Negative = debit, positive = credit (or use direction)."
},
"balance": {
"type": "number",
"description": "Running balance after this transaction, if known."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code for this transaction, if known."
},
"accountId": {
"type": "string",
"description": "References accounts[].id — the account this transaction belongs to. Omit for single-account statements."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Explicit direction. If omitted, inferred from amount sign."
},
"description": {
"type": "string",
"description": "Transaction description as printed on the statement."
},
"originalData": {
"type": "object",
"description": "Raw column values as on the PDF. Omit if unavailable — never fabricate a value; an absence scores the parsed dimension's raw fields 0 rather than polluting the measurement.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
}
},
"maxItems": 2000,
"minItems": 1,
"description": "Parsed transactions (1-2000)"
}
}
}Your remaining Bankstatemently credits — the processing quota, NOT credit/debit transactions. Use for: how many credits do I have, remaining pages, plan limits, quota, how many pages can I upload. 1 credit = 1 page of bank statement processing. Also reports your plan's operational limits (max pages per upload, max upload size, daily spend cap) so you can size a multi-file batch correctly before starting it.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Fetch the full converted data for a previously processed document. Use this after convert_statement returns a "processing" status, or to re-fetch results. output_format "json" (default) returns the data inline, renderable in chat. The other formats (csv, xlsx, qbo, xero) return a time-limited download link instead: present it as a normal link. data_mode selects which projection of the data you get: omit it for each output_format's existing default behavior. "normalized" is the cleaned, interpreted view; "original" includes each transaction's raw column values exactly as printed on the source PDF (originalData); "enhanced" is a reformatted view of the original columns (csv/xlsx only for now). Fetch data_mode: "original" when you plan to submit results to evaluate_benchmark — pass its originalData through verbatim; an absent originalData scores that benchmark's raw-fidelity dimension 0 for this document. Every response includes a "summary" field: use it as the single source of truth for what happened. If the conversation is not in English, translate it faithfully into the conversation language; never add details it doesn't contain. Never echo raw status values (e.g. "completed") or field names.
| Argument | Type | Description |
|---|---|---|
| limit | integer | output_format "json" only. Max transactions to return (default 500, capped at 2000, or 500 with data_mode "original"). |
| offset | integer | output_format "json" only. Number of transactions to skip. Omit to start from the beginning. |
| data_mode | string | Omit for each output_format's existing default behavior (json: normalized; csv/xlsx: the export route's own default). "normalized": the cleaned, interpreted data. "original": includes each transaction's raw column values as printed on the source PDF (originalData) — fetch this before submitting to evaluate_benchmark. "enhanced": a reformatted view of the original columns; only available for output_format csv/xlsx today. qbo/xero always export normalized data — omit data_mode (or pass "normalized" explicitly) for those formats. |
Group transactions by a dimension (month/category/counterparty/account/currency) and apply a metric to each group. Results are per-currency. The "counterparty" dimension keys on the printed counterparty, else a printed account mask (••1234), else the description's name tokens, so a rail word or reference number never splits one payee; a line with no key groups under "unknown". Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| filter | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| metric* | string | Metric per group. |
| dimension* | string | Grouping dimension. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dimension",
"metric"
],
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"filter": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"metric": {
"enum": [
"sum",
"average",
"count",
"max",
"min"
],
"type": "string",
"description": "Metric per group."
},
"dimension": {
"enum": [
"month",
"category",
"counterparty",
"account",
"currency"
],
"type": "string",
"description": "Grouping dimension."
}
}
}List your memories, default memory first. The default memory covers the whole workspace. Named memories include name, situation and scope. Free to use — no credits consumed.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Every debit that left your accounts — in no confirmed transfer between your own accounts, and not a fee — each in ONE destination whose kind is also its next step: "own-account" (a printed account mask that names one of your accounts and no matched credit was found: ask for that account's statement), "account" (a printed account mask for an account outside your statements: request that account's statements; an in-kind move such as securities, crypto or escrow starts as a wire to that account and becomes visible only once the receiving statement is uploaded), "cash" (cash out: where it went cannot be followed, so the cumulative amount is the finding), "name" (a named party: review whether it was household spending) and "unknown" (nowhere the line says; kept visible, one entry per line, never merged). A destination carries the cumulative amount sent, per currency, never a balance. "mayBeOwnAccount" lists debits in an open candidate pair ("may be a move between your own accounts") apart, in no total. "unresolved" lists debits whose documents conflict about where they went (a transfer term and a payment term, no category to settle it) apart, in no total: the documents do not say where they went, so say so and ask the person to confirm. THE way to answer "did money disappear from my accounts, and where do I look next" — never answer it by summing list_transactions rows. Pass "dateRange" ({ from, to }, inclusive, YYYY-MM-DD) to report only debits in that range, for example from a separation date: transfers are matched over the whole scope first, so a transfer whose credit lies outside the range is still a transfer, never an outflow. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range (a scope date range also narrows what is matched — prefer "dateRange").
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
Browse your previously converted bank statements with pagination and optional status filter.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (1-100) |
| offset | integer | Pagination offset |
| status | string | Filter by status |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Max results (1-100)"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset"
},
"status": {
"enum": [
"processing",
"completed",
"failed"
],
"type": "string",
"description": "Filter by status"
}
}
}A transaction is a single line as printed on one account's statement — one side of any movement. Return a filtered list of transactions across your converted statements, capped at 50 rows. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range. Every response names the scope it actually evaluated (document count + covered date range) and each returned row carries its source document's content_hash so you can cite it. For "how many credits do I have" / processing quota / remaining pages, use get_credits instead — that is not a transaction.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum rows to return. Default 20, max 50. |
| order | string | Sort direction. Default "desc" (largest amount / most recent date first). Only meaningful with sort_by. |
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| filter | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| sort_by | string | Sort the filtered set before applying limit. "amount" ranks by absolute magnitude (signed amounts are still returned). Omit for today's default (encounter order). |
Match transfers between your own accounts. A transfer is TWO transactions — a debit leaving one of your accounts and a credit arriving in another — matched as two sides of the same movement (amount and date aligned); account-level successions (an account closing into a successor) are matched too. A payment to an outside party is not a transfer here: only movements with both sides visible in your statements are matched. THE way to answer any "was money moved between my accounts" / "did I transfer X" question — never try to answer a money-moved-between-accounts question with list_transactions + arithmetic; always call this tool instead. Ties come back as "ambiguous" until decided; call adjudicate_transfers to decide them. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range. Every response reports the match window (in days) it used, even when no transfers are found — a lack of matches is never silent about how hard it looked. To find large movements with NO matching counterpart in your other accounts — e.g. "trace transfers over $10,000; which ones leave without a known destination?" — pass "amountMin": reconciled pairs and successions are filtered to that floor, and the response gains an "unmatched" bucket of large movements (debits leaving, or unexplained credits arriving) with no matching pair, candidate, or succession. Omit amountMin for the ordinary reconciled-pairs answer.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| amountMin | number | Inclusive minimum absolute amount. When present, transfers/accountSuccessions are floored to this amount and the response gains an "unmatched" bucket of large movements with no matching counterpart. Omit for the ordinary reconciled-pairs answer. |
Report how well a previously converted bank statement was parsed: submit a 1-5 rating, optionally with structured feedback at any rating. Your rating counts toward the average ratings shown on bankstatemently.com. Calling this again for the same document updates your existing rating without clearing feedback already submitted for it. Returns the stored rating state in the response — there is no separate tool to read your own rating back. Every response includes a "summary" field: use it as the single source of truth for what happened.
| Argument | Type | Description |
|---|---|---|
| rating* | integer | 1-5 star rating for this conversion |
| feedback | string | Free-text feedback. |
| document_id* | string | Document ID (from convert_statement or list_statements) |
| feedback_categories | array | Structured feedback categories. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id",
"rating"
],
"properties": {
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "1-5 star rating for this conversion"
},
"feedback": {
"type": "string",
"maxLength": 1000,
"description": "Free-text feedback."
},
"document_id": {
"type": "string",
"description": "Document ID (from convert_statement or list_statements)"
},
"feedback_categories": {
"type": "array",
"items": {
"enum": [
"missing_transactions",
"incorrect_amounts",
"export_issue",
"wrong_dates",
"formatting_issue",
"other"
],
"type": "string"
},
"description": "Structured feedback categories."
}
}
}Mint a single-use upload URL for pushing a conversation-attached PDF to Bankstatemently before converting it. Use this ONLY when you have no other way to reference the attached file (no pdf_file/pdf_url equivalent for this host) — e.g. a code-execution sandbox that can see the file on disk but has no URL for it. Playbook: (1) check your sandbox's uploads/attachments directory first — if the file isn't there yet, the mount can lag behind the conversation; ask the user to re-attach or wait a moment and check again before calling this tool. (2) Call request_upload to get upload_url and upload_id. (3) PUT the raw PDF bytes to upload_url with header Content-Type: application/pdf, e.g.: `curl -X PUT "<upload_url>" -H "Content-Type: application/pdf" --data-binary @<path-to-file>`. (4) Once the PUT succeeds, call convert_statement with upload_id set to the same value — never pdf/pdf_url/pdf_file for this flow. The URL and token are single-use and expire quickly; call request_upload again for a fresh one if the PUT fails partway through — never retry a failed PUT against the same URL. If the PUT fails with a network error or a "host not allowed"-style denial, the sandbox is likely blocking outbound requests to api.bankstatemently.com — tell the user to add api.bankstatemently.com to their host's code-execution allowed-domains setting (on claude.ai: Settings → Capabilities → Code execution) and retry. To convert several statements at once, pass count (1-100) instead of calling this tool once per file: the response returns "uploads", an array of that many { upload_id, upload_url } pairs — PUT each file to its own upload_url, then make ONE convert_statement call with upload_ids set to every upload_id. Free to use — no credits consumed (conversion itself still costs credits, same as any other convert_statement call).
| Argument | Type | Description |
|---|---|---|
| count | integer | Batch size — mint this many independent single-use upload URLs in one call instead of calling request_upload once per file. When set, the response returns "uploads": an array of that many { upload_id, upload_url } pairs. Omit for the default single-URL response. |
Compute a time series by grouping transactions into week or month buckets and applying a metric — useful for trends. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range.
| Argument | Type | Description |
|---|---|---|
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| bucket* | string | Bucket size. |
| filter | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| metric* | string | Metric per bucket. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bucket",
"metric"
],
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"bucket": {
"enum": [
"week",
"month"
],
"type": "string",
"description": "Bucket size."
},
"filter": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"metric": {
"enum": [
"sum",
"average",
"count",
"max",
"min"
],
"type": "string",
"description": "Metric per bucket."
}
}
}Return the top N groups ranked by metric (descending), per-currency for monetary metrics. Scope defaults to all your completed statements; pass "scope" to narrow to specific accounts/products and/or a date range.
| Argument | Type | Description |
|---|---|---|
| n* | number | Number of top groups to return. |
| scope | object | Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. "accounts" is a list of account/product chips ({ kind: "account" | "product", id }, the id of an account descriptor or product returned by a tool); "dateRange" bounds by transaction date (YYYY-MM-DD). |
| filter | object | Subset of transactions to operate on. All fields are optional and combined with AND logic. |
| metric* | string | Metric to rank by. |
| dimension* | string | Grouping dimension. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dimension",
"metric",
"n"
],
"properties": {
"n": {
"type": "number",
"description": "Number of top groups to return."
},
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"filter": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"metric": {
"enum": [
"sum",
"average",
"count",
"max",
"min"
],
"type": "string",
"description": "Metric to rank by."
},
"dimension": {
"enum": [
"month",
"category",
"counterparty",
"account",
"currency"
],
"type": "string",
"description": "Grouping dimension."
}
}
}Rename or rescope an existing named memory, or update its situation. The default memory is immutable. Free to use — no credits consumed.
| Argument | Type | Description |
|---|---|---|
| name | string | New user-authored memory name. |
| scope | object | Updated accounts/products and optional date range this memory covers. |
| memoryId* | string | The id of the named memory to update. The default memory is immutable. |
| situation | any | Updated matter this memory is about: bookkeeping, divorce, estate, or null. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"memoryId"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "New user-authored memory name."
},
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Updated accounts/products and optional date range this memory covers."
},
"memoryId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The id of the named memory to update. The default memory is immutable."
},
"situation": {
"anyOf": [
{
"enum": [
"bookkeeping",
"divorce",
"estate"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Updated matter this memory is about: bookkeeping, divorce, estate, or null."
}
}
}| object |
| An attached PDF (populated automatically by ChatGPT — do not construct this yourself). |
| upload_id | string | An upload_id from request_upload, after PUTting the file to its upload_url. Use this only when your host has no other way to reference the attached file (no pdf_file/pdf_url equivalent). |
| upload_ids | array | Batch of upload_ids from a single request_upload(count) call, each already PUT to its own upload_url — converts many statements in one call. Mutually exclusive with pdf, pdf_url, pdf_file, and upload_id. Admission only: the response reports per-file status immediately, never waiting for conversion — fetch results per document_id via get_statement. |
| output_format | string | Output format |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pdf": {
"type": "string",
"description": "Base64-encoded PDF content — last resort only; prefer pdf_file for an attachment or pdf_url for a link"
},
"pdf_url": {
"type": "string",
"format": "uri",
"description": "HTTPS URL to fetch the PDF from"
},
"password": {
"type": "string",
"description": "Password for encrypted PDFs"
},
"pdf_file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT's identifier for the attached file."
},
"file_name": {
"type": "string",
"description": "Original filename of the attached file, when ChatGPT provides one."
},
"mime_type": {
"type": "string",
"description": "MIME type of the attached file, when ChatGPT provides one."
},
"download_url": {
"type": "string",
"description": "Signed URL ChatGPT provides to fetch the attached PDF's bytes."
}
},
"description": "An attached PDF (populated automatically by ChatGPT — do not construct this yourself)."
},
"upload_id": {
"type": "string",
"description": "An upload_id from request_upload, after PUTting the file to its upload_url. Use this only when your host has no other way to reference the attached file (no pdf_file/pdf_url equivalent)."
},
"upload_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"description": "Batch of upload_ids from a single request_upload(count) call, each already PUT to its own upload_url — converts many statements in one call. Mutually exclusive with pdf, pdf_url, pdf_file, and upload_id. Admission only: the response reports per-file status immediately, never waiting for conversion — fetch results per document_id via get_statement."
},
"output_format": {
"enum": [
"json",
"csv",
"xlsx",
"qbo",
"xero"
],
"type": "string",
"default": "json",
"description": "Output format"
}
}
}| document_id* | string | Document ID (from convert_statement or list_statements) |
| output_format | string | Output format |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"document_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "output_format \"json\" only. Max transactions to return (default 500, capped at 2000, or 500 with data_mode \"original\")."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "output_format \"json\" only. Number of transactions to skip. Omit to start from the beginning."
},
"data_mode": {
"enum": [
"original",
"enhanced",
"normalized"
],
"type": "string",
"description": "Omit for each output_format's existing default behavior (json: normalized; csv/xlsx: the export route's own default). \"normalized\": the cleaned, interpreted data. \"original\": includes each transaction's raw column values as printed on the source PDF (originalData) — fetch this before submitting to evaluate_benchmark. \"enhanced\": a reformatted view of the original columns; only available for output_format csv/xlsx today. qbo/xero always export normalized data — omit data_mode (or pass \"normalized\" explicitly) for those formats."
},
"document_id": {
"type": "string",
"description": "Document ID (from convert_statement or list_statements)"
},
"output_format": {
"enum": [
"json",
"csv",
"xlsx",
"qbo",
"xero"
],
"type": "string",
"default": "json",
"description": "Output format"
}
}
}| dateRange | object | Report only debits dated in this inclusive range. Omit to report every date. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive end of the range."
},
"from": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive start of the range."
}
},
"description": "Report only debits dated in this inclusive range. Omit to report every date.",
"additionalProperties": false
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "number",
"description": "Maximum rows to return. Default 20, max 50."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction. Default \"desc\" (largest amount / most recent date first). Only meaningful with sort_by."
},
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"filter": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Whole-row text search over raw transaction fields (case-insensitive)."
},
"dateEnd": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive upper bound."
},
"category": {
"enum": [
"income",
"transfers",
"payroll",
"rent_premises",
"utilities_telecom",
"software_subscriptions",
"professional_services",
"bank_fees_interest",
"taxes_government",
"travel_vehicle",
"meals_entertainment",
"supplies_equipment",
"insurance_health",
"loan_payments",
"groceries_personal",
"cash",
"other"
],
"type": "string",
"description": "Category slug, e.g. \"meals_entertainment\", \"groceries_personal\"."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency code. E.g. \"USD\", \"HKD\"."
},
"merchant": {
"type": "string",
"description": "Substring match against description or counterparty (case-insensitive)."
},
"amountMax": {
"type": "number",
"description": "Inclusive maximum absolute amount."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount."
},
"dateStart": {
"type": "string",
"description": "ISO date (YYYY-MM-DD). Inclusive lower bound."
},
"direction": {
"enum": [
"credit",
"debit"
],
"type": "string",
"description": "Semantic direction."
}
},
"description": "Subset of transactions to operate on. All fields are optional and combined with AND logic.",
"additionalProperties": false
},
"sort_by": {
"enum": [
"amount",
"date"
],
"type": "string",
"description": "Sort the filtered set before applying limit. \"amount\" ranks by absolute magnitude (signed amounts are still returned). Omit for today's default (encounter order)."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scope": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The account id: the `id` of an account descriptor returned by a tool, or of a statement tool `accounts[]` entry."
},
"kind": {
"type": "string",
"const": "account",
"description": "This chip addresses a single account."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The product id: the `id` of a product returned by a statement tool (`get_statement` / `convert_statement`, `products[].id`)."
},
"kind": {
"type": "string",
"const": "product",
"description": "This chip addresses a product and expands to its child accounts."
}
},
"additionalProperties": false
}
]
},
"description": "Account/product id chips (kind + id) to scope to. Empty = all accounts."
},
"dateRange": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End of the date range (inclusive), YYYY-MM-DD."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start of the date range (inclusive), YYYY-MM-DD."
}
},
"description": "Bounds results to transactions within this date range. Omit for no date filter."
}
},
"description": "Optional structural scope (WHO × WHEN). Omit to search across all your completed statements. \"accounts\" is a list of account/product chips ({ kind: \"account\" | \"product\", id }, the id of an account descriptor or product returned by a tool); \"dateRange\" bounds by transaction date (YYYY-MM-DD)."
},
"amountMin": {
"type": "number",
"description": "Inclusive minimum absolute amount. When present, transfers/accountSuccessions are floored to this amount and the response gains an \"unmatched\" bucket of large movements with no matching counterpart. Omit for the ordinary reconciled-pairs answer."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Batch size — mint this many independent single-use upload URLs in one call instead of calling request_upload once per file. When set, the response returns \"uploads\": an array of that many { upload_id, upload_url } pairs. Omit for the default single-URL response."
}
}
}