In der Referenz stöbern

Budgets

9 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.

Budget snapshot for the given month (YYYY-MM) including ABT and per-category state

GET/households/{householdId}/budgets/{yearMonth}

read:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/budgets/{yearMonth}

Antwort200 · Success

Raise every category with a goal to its suggested monthly amount, capped by ABT

POST/households/{householdId}/budgets/{yearMonth}/auto-assign-from-goals

write:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/budgets/{yearMonth}/auto-assign-from-goals

Antwort200 · Success

Snapshot for a single category in the given month

GET/households/{householdId}/budgets/{yearMonth}/categories/{categoryId}

read:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich
categoryId	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/budgets/{yearMonth}/categories/{categoryId}

Antwort200 · Success

Assign or update the amount a category receives this month

PATCH/households/{householdId}/budgets/{yearMonth}/categories/{categoryId}

write:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich
categoryId	path	Erforderlich

Request-Body

json

{  "assignedCents": 50000}

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X PATCH https://api.vokse.ai/households/current/budgets/{yearMonth}/categories/{categoryId} \     -d '{"assignedCents":50000}'

Antwort200 · Success

Assignment history for one category in the given month: every assign and every money move in or out, newest first

GET/households/{householdId}/budgets/{yearMonth}/categories/{categoryId}/history

read:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich
categoryId	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/budgets/{yearMonth}/categories/{categoryId}/history

Antwort200 · Success

Copy every assignment from sourceYearMonth into yearMonth (overwrites destination)

POST/households/{householdId}/budgets/{yearMonth}/copy-from/{sourceYearMonth}

write:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich
sourceYearMonth	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/budgets/{yearMonth}/copy-from/{sourceYearMonth}

Antwort200 · Success

Move money from one category to another within a single month (atomic, conservative)

POST/households/{householdId}/budgets/{yearMonth}/move

write:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich

Request-Body

json

{  "fromCategoryId": "01J8ME9B7QW3ZK5X2V8T4R6S1D",  "toCategoryId": "01J8ME9D8VK2QW4X6T3R5S7Z9M",  "amountCents": 10000}

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/budgets/{yearMonth}/move \     -d '{"fromCategoryId":"01J8ME9B7QW3ZK5X2V8T4R6S1D","toCategoryId":"01J8ME9D8VK2QW4X6T3R5S7Z9M","amountCents":10000}'

Antwort200 · Success

Clear every assignment in this month (owner only)

POST/households/{householdId}/budgets/{yearMonth}/reset

write:budgets

Parameter

Name	Ort	Erforderlich
yearMonth	path	Erforderlich

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/budgets/{yearMonth}/reset

Antwort200 · Success

Age of Money: mean days the money you spend sat in on-budget cash accounts (last 10 outflows, FIFO); null until 10 outflows exist

GET/households/{householdId}/budgets/age-of-money

read:budgets

Beispielanfrage

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/budgets/age-of-money

Antwort200 · Success