Dashboard Read API

All read endpoints require verified Google identity nicolasdelauretis122@gmail.com. Requests from other accounts or missing credentials return 401/403.

Endpoints Summary

Endpoint	Method	Purpose
/v1/finances/movements	GET	Paginated movements list with multifaceted filters
/v1/finances/movements/{id}	GET	Detailed movement with linked refund links & installments
/v1/finances/categories	GET	Category tree hierarchy
/v1/finances/accounts	GET	Financial accounts and instruments
/v1/finances/budgets	GET	Monthly budget progress and percentage consumed
/v1/finances/installments	GET	Future installment schedule grouped by due month

Query Parameters

GET /v1/finances/movements

• from (YYYY-MM-DD): Lower boundary for transaction date.
• to (YYYY-MM-DD): Upper boundary for transaction date.
• status: Filter by pending, estimated, or confirmed.
• kind: Filter by income, expense, transfer_own, card_payment, or refund.
• category_id: Specific category key.
• account_id: Movements involving this account as source or destination.
• currency: ISO code (e.g. ARS, USD).
• cursor: Pagination marker (transaction date).
• limit: Number of items per page (default: 50, maximum: 100).

Response Structure

{
  "data": [
    {
      "id": "mov-coto-101",
      "kind": "expense",
      "status": "confirmed",
      "description": "Coto Supermercado",
      "occurred_on": "2026-11-10",
      "amount_minor": 4500000,
      "currency": "ARS",
      "category_id": "cat-super",
      "from_account_id": "acc-bbva-ars",
      "revision": 1
    }
  ],
  "pagination": {
    "cursor": "2026-11-10",
    "has_more": false,
    "total": 1,
    "limit": 50
  },
  "meta": {
    "owner_id": "usr_nicolas_delau",
    "basis": "adjusted_original"
  }
}