EnvelopeBudget

Query and manage budgets on EnvelopeBudget.com via REST API.

Setup

• Requires env: ENVELOPE_BUDGET_API_KEY
• API reference: see references/api-reference.md

Usage

Use the helper script for all API calls:

scripts/eb_api.sh <METHOD> <path> [json_body]

Common workflows

Check budget overview:

scripts/eb_api.sh GET /api/budgets
scripts/eb_api.sh GET /api/budgets/BUDGET_ID/available-to-budget

List recent transactions:

scripts/eb_api.sh GET "/api/transactions/BUDGET_ID?limit=20"
scripts/eb_api.sh GET "/api/transactions/BUDGET_ID?search=grocery&limit=10"

Add a transaction (amounts in cents, negative = spending):

scripts/eb_api.sh POST /api/transactions/BUDGET_ID \
  '{"account_id":"ACCT_ID","payee":"Costco","envelope_id":"ENV_ID","date":"2026-03-06","amount":-8500,"memo":"Groceries"}'

Check envelope balances:

scripts/eb_api.sh GET /api/envelopes/BUDGET_ID

Transfer between envelopes:

scripts/eb_api.sh POST /api/envelopes/BUDGET_ID/transfer \
  '{"from_envelope_id":"FROM_ID","to_envelope_id":"TO_ID","amount":5000}'

Spending report:

scripts/eb_api.sh GET /api/reports/spending-by-category-data/BUDGET_ID

Important notes

• Amounts are in cents: $50.00 = 5000, -$25.50 = -2550
• Negative = outflow (spending), Positive = inflow (income)
• Always fetch budgets first to get budget_id, then accounts/envelopes for their IDs
• For full API details: read references/api-reference.md