Authentication
Requires a valid JWT token in the Authorization header.Query Parameters
Filter expenses by profile UUID. If not provided, returns expenses from all profiles.
Filter by month (1-12).
Filter by year.
Filter by payment type. Allowed values: “PUE”, “PPD”, “COMPLEMENTO_PAGO”.
Filter by category.
Filter by tax regime of the receiver (3-digit SAT code).
Search across RFC (issuer/receiver), names, and concept. Uses case-insensitive partial matching.
Page number for pagination (starts at 1).
Number of items per page (max 100).
Response
Array of expense objects.
UUID of the expense.
UUID of the associated profile.
Origin type: “XML” (from CFDI) or “MANUAL” (manually created).
Date of the expense (ISO 8601).
Month (1-12).
Year.
Total amount.
Subtotal amount.
IVA percentage.
IVA amount.
Expense description.
Expense category.
Fiscal folio UUID (for XML expenses).
Payment type: “PUE”, “PPD”, or “COMPLEMENTO_PAGO”.
Issuer RFC.
Issuer name.
Receiver RFC.
Receiver name.
Example Request
cURL
Example with Search
cURL
Error Responses
Unauthorized - Invalid or missing JWT token.
Internal server error.