---
title: "The deliberate budget for one trip: total, per-category envelopes with spend attributed, every line item (seeded rows la"
method: POST
path: "/actions/get_trip_budget"
tags: ["budget"]
---

# The deliberate budget for one trip: total, per-category envelopes with spend attributed, every line item (seeded rows la

`POST /actions/get_trip_budget`

## Request

- Base URL: `https://findinghorizons.ca/api/v1`
- URL: `https://findinghorizons.ca/api/v1/actions/get_trip_budget`
- Auth: OAuth 2 (authorization code, authorization URL `https://findinghorizons.ca/api/mcp/authorize`, token URL `https://findinghorizons.ca/api/mcp/oauth/token`, scopes: `budget:read`)

The deliberate budget for one trip: total, per-category envelopes with spend attributed, every line item (seeded rows labelled as derived), planned vs actual totals converted to the budget currency, and the per-day figure. Amounts in a currency with no FX rate are EXCLUDED and listed — `remaining` is a ceiling, not a fact, whenever that happens. Pass `date` (YYYY-MM-DD) to get the per-day figure; without it the figure is absent, never guessed from the server clock. A trip with no budget returns available:false, not zeroes.

## Request body

- object
  - `tripId` string, required: Trip id from get_my_trips
  - `date` string: The traveller's calendar date, YYYY-MM-DD — required for the per-day figure
  - `today` string: The traveller's own date, YYYY-MM-DD, where the action needs one

## Response `200`

Done — { ok, api, action, result, card, operation? }

## Other responses

- `400`: Bad body / missing Idempotency-Key
- `401`: No or invalid token
- `403`: Scope not granted
- `422`: The action said no
- `429`: Rate limited

---

[API](https://skmtc.dev/findinghorizons/apis/finding-horizons-api.md) · [All operations](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/revisions/e347f6070173?raw)