Sfoglia il riferimento

Ricorrenze

13 endpoint · Le descrizioni degli endpoint sono in inglese.

List recurrences in the household

GET/households/{householdId}/recurrences

read:recurrences

Richiesta di esempio

bash

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

Risposta200 · Success

Create a recurring transaction schedule

POST/households/{householdId}/recurrences

write:recurrences

Corpo della richiesta

json

{  "name": "Streaming service",  "accountId": "01J8ME9AZ2K3W7X4V5T6R7Q8S9",  "amountCents": -1599,  "currency": "EUR",  "frequency": "monthly",  "dayOfMonth": 1,  "startDate": "2026-07-01"}

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/recurrences \     -d '{"name":"Streaming service","accountId":"01J8ME9AZ2K3W7X4V5T6R7Q8S9","amountCents":-1599,"currency":"EUR","frequency":"monthly","dayOfMonth":1,"startDate":"2026-07-01"}'

Risposta201 · Success

Fetch a single recurrence

GET/households/{householdId}/recurrences/{id}

read:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Update a recurrence (recomputes nextRunDate if schedule changes)

PATCH/households/{householdId}/recurrences/{id}

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Corpo della richiesta

json

{  "amountCents": -1999}

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/recurrences/{id} \     -d '{"amountCents":-1999}'

Risposta200 · Success

Soft-delete a recurrence

DELETE/households/{householdId}/recurrences/{id}

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

Force immediate materialization of the next due run (idempotent on external_id)

POST/households/{householdId}/recurrences/{id}/materialize-now

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Pause a recurrence (status → paused, no further runs)

POST/households/{householdId}/recurrences/{id}/pause

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Resume a paused recurrence

POST/households/{householdId}/recurrences/{id}/resume

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
id	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Recurring charges detected in the household activity that are not scheduled yet, plus price changes on tracked ones (ADR 0109)

GET/households/{householdId}/recurrences/suggestions

read:recurrences

Richiesta di esempio

bash

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

Risposta200 · Success

Accept a suggestion: create the recurrence (origin detected) or apply the price change

POST/households/{householdId}/recurrences/suggestions/{key}/accept

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
key	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Dismiss a suggestion ("not recurring"); it stays hidden across recomputations

POST/households/{householdId}/recurrences/suggestions/{key}/dismiss

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
key	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

Undo a dismissal

DELETE/households/{householdId}/recurrences/suggestions/{key}/dismiss

write:recurrences

Parametri

Nome	Posizione	Obbligatorio
key	path	Obbligatorio

Richiesta di esempio

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/households/current/recurrences/suggestions/{key}/dismiss

Risposta204 · No content

What is coming in a window: recurrence occurrences, pending recurring rows, future one-off rows and card payment due days

GET/households/{householdId}/recurrences/upcoming

read:recurrences

Richiesta di esempio

bash

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

Risposta200 · Success