Parcourir la référence

Récurrences

13 endpoints · Les descriptions des points de terminaison sont en anglais.

List recurrences in the household

GET/households/{householdId}/recurrences

read:recurrences

Exemple de requête

bash

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

Réponse200 · Success

Create a recurring transaction schedule

POST/households/{householdId}/recurrences

write:recurrences

Corps de la requête

json

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

Exemple de requête

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"}'

Réponse201 · Success

Fetch a single recurrence

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

read:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

Update a recurrence (recomputes nextRunDate if schedule changes)

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Corps de la requête

json

{  "amountCents": -1999}

Exemple de requête

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}'

Réponse200 · Success

Soft-delete a recurrence

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse204 · No content

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

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

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

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

Resume a paused recurrence

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
id	path	Requis

Exemple de requête

bash

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

Réponse200 · 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

Exemple de requête

bash

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

Réponse200 · Success

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

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
key	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

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

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
key	path	Requis

Exemple de requête

bash

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

Réponse204 · No content

Undo a dismissal

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

write:recurrences

Paramètres

Nom	Emplacement	Requis
key	path	Requis

Exemple de requête

bash

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

Réponse204 · 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

Exemple de requête

bash

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

Réponse200 · Success