---
title: "Get expense cash summary"
description: "Summarize manual operational cash outflows for one business day. It includes paid manual expenses and payments allocated to manual credit expenses. It excludes received CFDI invoices and unpaid manual expenses. Historical coverage is forward-only until a backfill is intentionally run."
language: en
canonical_url: "https://exac.mx/docs/en/mcp/tools/get_expense_cash_summary"
md_url: "https://exac.mx/docs/en/mcp/tools/get_expense_cash_summary.md"
---

# Get expense cash summary

Summarize manual operational cash outflows for one business day. It includes paid manual expenses and payments allocated to manual credit expenses. It excludes received CFDI invoices and unpaid manual expenses. Historical coverage is forward-only until a backfill is intentionally run.

Tool: `get_expense_cash_summary`

## Purpose

Summarize manual operational cash outflows for a business day.

### Use when

You need paid manual expense cash flow.

### Do not use when

You need received CFDI expenses or unpaid expense balances.

| Detail | Value |
| --- | --- |
| Permissions | analytics:read |
| Side effects | None |
| Idempotency | Idempotent |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "date": {
      "description": "Business date in YYYY-MM-DD; defaults to the org's today",
      "allOf": [
        {
          "$ref": "#/definitions/__schema0"
        }
      ]
    },
    "activityLimit": {
      "description": "Top suppliers, categories, and locations; defaults to 4",
      "allOf": [
        {
          "$ref": "#/definitions/__schema1"
        }
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "__schema0": {
      "type": "string"
    },
    "__schema1": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string",
          "const": "cash_expenses"
        },
        "currency": {
          "type": "string",
          "const": "MXN"
        },
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
        },
        "historicalCoverage": {
          "type": "string",
          "const": "forward_only"
        },
        "accountingBasis": {
          "type": "string",
          "const": "cash"
        },
        "totals": {
          "type": "object",
          "properties": {
            "cashOutflow": {
              "type": "number"
            },
            "movementCount": {
              "type": "number"
            },
            "classified": {
              "type": "number"
            },
            "unclassified": {
              "type": "number"
            },
            "unallocated": {
              "type": "number"
            }
          },
          "required": [
            "cashOutflow",
            "movementCount",
            "classified",
            "unclassified",
            "unallocated"
          ],
          "additionalProperties": false
        },
        "bySource": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/__schema0"
          }
        },
        "byPaymentMethod": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/__schema0"
          }
        },
        "top": {
          "type": "object",
          "properties": {
            "suppliers": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/__schema1"
              }
            },
            "categories": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/__schema1"
              }
            },
            "locations": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/__schema1"
              }
            }
          },
          "required": [
            "suppliers",
            "categories",
            "locations"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "source",
        "currency",
        "date",
        "historicalCoverage",
        "accountingBasis",
        "totals",
        "bySource",
        "byPaymentMethod",
        "top"
      ],
      "additionalProperties": false
    },
    "error": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "validation_error",
            "unauthenticated",
            "forbidden",
            "not_found",
            "method_not_allowed",
            "conflict",
            "idempotency_conflict",
            "operation_in_progress",
            "recovery_required",
            "rate_limited",
            "provider_unavailable",
            "internal"
          ]
        },
        "message": {
          "type": "string"
        },
        "details": {
          "type": "object",
          "properties": {
            "issues": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "path": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        }
                      ]
                    }
                  },
                  "message": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  }
                },
                "required": [
                  "path",
                  "message"
                ],
                "additionalProperties": false
              }
            },
            "retryable": {
              "type": "boolean"
            },
            "retryAfterSeconds": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "definitions": {
    "__schema0": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string"
        },
        "amount": {
          "type": "number"
        },
        "share": {
          "type": "number"
        }
      },
      "required": [
        "key",
        "amount",
        "share"
      ],
      "additionalProperties": false
    },
    "__schema1": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "amount": {
          "type": "number"
        },
        "movementCount": {
          "type": "number"
        },
        "share": {
          "type": "number"
        }
      },
      "required": [
        "name",
        "amount",
        "movementCount",
        "share"
      ],
      "additionalProperties": false
    }
  },
  "oneOf": [
    {
      "required": [
        "data"
      ]
    },
    {
      "required": [
        "error"
      ]
    }
  ]
}
```

## Related tools

- [`get_cfdi_summary`](/docs/en/mcp/tools/get_cfdi_summary.md) — **Get CFDI summary**: Summarize CFDI activity for a month range: recognized income, recognized expenses, payroll paid, payroll received, balance, and top contributors. Every payroll contributor has a paid or received direction. Uses CFDI aggregates only. It excludes receipt/POS sales and is never a source for taxes paid or owed.

- [`search_documents`](/docs/en/mcp/tools/search_documents.md) — **Search documents**: Search one public document family at a time. Use cfdi for income, credit-note, transfer, payroll, and payment-complement documents; use withholding, sales_receipt, quote, expense, declaration, tax_compliance_opinion, or sales_receipt_refund for the other families.

## Related workflow

[See the canonical workflows in the introduction](/docs/en.md)

## Equivalent REST operations

- [`GET /v1/reports/expenses`](/docs/en/api/tax-reports/reports/get-expense-cash-report.md)

Complete documentation: https://exac.mx/docs/en.md
Agent documentation index: https://exac.mx/docs/en/llms.txt