Sfoglia il riferimento

Conti

14 endpoint · Le descrizioni degli endpoint sono in inglese.

List accounts in this household

GET/households/{householdId}/accounts

read:accounts

Parametri

Nome	Posizione	Obbligatorio
status	query	Facoltativo

Richiesta di esempio

bash

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

Risposta200 · Success

Create a financial account

POST/households/{householdId}/accounts

write:accounts

Corpo della richiesta

json

{  "name": "Everyday checking",  "type": "checking",  "currency": "EUR",  "balanceCents": "125000"}

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/accounts \     -d '{"name":"Everyday checking","type":"checking","currency":"EUR","balanceCents":"125000"}'

Risposta201 · Success

Get a single account with its computed balance

GET/households/{householdId}/accounts/{accountId}

read:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Update an account

PATCH/households/{householdId}/accounts/{accountId}

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Corpo della richiesta

json

{  "name": "Joint checking"}

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Content-Type: application/json" \     -H "Idempotency-Key: $(uuidgen)" \     -X PATCH https://api.vokse.ai/households/current/accounts/{accountId} \     -d '{"name":"Joint checking"}'

Risposta200 · Success

Soft-delete an account (rejects non-zero balance unless force)

DELETE/households/{householdId}/accounts/{accountId}

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio
force	query	Facoltativo

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/households/current/accounts/{accountId}

Risposta204 · No content

Daily running balance for an account

GET/households/{householdId}/accounts/{accountId}/balance-history

read:accounts

Parametri

Nome	Posizione	Obbligatorio	Descrizione
accountId	path	Obbligatorio	-
fromDate	query	Facoltativo	YYYY-MM-DD
toDate	query	Facoltativo	YYYY-MM-DD

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/accounts/{accountId}/balance-history

Risposta200 · Success

Close an account; any remaining balance is booked as a balance adjustment dated on the caller's local day

POST/households/{householdId}/accounts/{accountId}/close

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Convert an account to another type (safe moves only: same group, cash<->credit, loan<->tracking; crossing the budget boundary is refused with guidance)

POST/households/{householdId}/accounts/{accountId}/convert

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Loan payoff planner: amortization with the current terms, optional extra monthly principal, and this month’s ledger split

GET/households/{householdId}/accounts/{accountId}/loan-projection

read:accounts

Parametri

Nome	Posizione	Obbligatorio	Descrizione
accountId	path	Obbligatorio	-
extraMonthlyCents	query	Facoltativo	Extra principal paid every month, integer cents

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/accounts/{accountId}/loan-projection

Risposta200 · Success

Loan payoff simulator: what-if projection for an alternative payment, recurring/one-off extras, or a target payoff month (solved to the required payment)

GET/households/{householdId}/accounts/{accountId}/loan-simulation

read:accounts

Parametri

Nome	Posizione	Obbligatorio	Descrizione
accountId	path	Obbligatorio	-
targetPayoffYearMonth	query	Facoltativo	Solve the minimal payment that pays off by this YYYY-MM
oneTimeExtraCents	query	Facoltativo	One-off extra principal this month, integer cents
extraMonthlyCents	query	Facoltativo	Extra principal every month, integer cents
paymentCents	query	Facoltativo	Alternative full monthly payment, integer cents

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/accounts/{accountId}/loan-simulation

Risposta200 · Success

Dated changes of a loan’s rate, payment and escrow (newest first)

GET/households/{householdId}/accounts/{accountId}/loan-terms-history

read:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/accounts/{accountId}/loan-terms-history

Risposta200 · Success

Reconcile account against the real bank balance: books an adjustment for any gap, then locks cleared transactions as reconciled

POST/households/{householdId}/accounts/{accountId}/reconcile

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Reopen a previously closed account

POST/households/{householdId}/accounts/{accountId}/reopen

write:accounts

Parametri

Nome	Posizione	Obbligatorio
accountId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Atomically set the manual position of accounts within their groups

POST/households/{householdId}/accounts/reorder

write:accounts

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -H "Idempotency-Key: $(uuidgen)" \     -X POST https://api.vokse.ai/households/current/accounts/reorder

Risposta204 · No content