Parcourir la référence

Bénéficiaires

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

List payees in this household

GET/households/{householdId}/payees

read:payees

Exemple de requête

bash

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

Réponse200 · Success

Create a payee

POST/households/{householdId}/payees

write:payees

Corps de la requête

json

{  "name": "Local supermarket"}

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/payees \     -d '{"name":"Local supermarket"}'

Réponse201 · Success

Get a payee

GET/households/{householdId}/payees/{payeeId}

read:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

Update a payee (recomputes normalized_name on rename)

PATCH/households/{householdId}/payees/{payeeId}

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis

Corps de la requête

json

{  "name": "Whole Foods"}

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/payees/{payeeId} \     -d '{"name":"Whole Foods"}'

Réponse200 · Success

Soft-delete a payee

DELETE/households/{householdId}/payees/{payeeId}

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis

Exemple de requête

bash

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

Réponse204 · No content

List aliases of a payee

GET/households/{householdId}/payees/{payeeId}/aliases

read:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis

Exemple de requête

bash

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

Réponse200 · Success

Add an alias to a payee (dedup by normalized form)

POST/households/{householdId}/payees/{payeeId}/aliases

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	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/payees/{payeeId}/aliases

Réponse201 · Success

Remove an alias

DELETE/households/{householdId}/payees/{payeeId}/aliases/{aliasId}

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis
aliasId	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X DELETE https://api.vokse.ai/households/current/payees/{payeeId}/aliases/{aliasId}

Réponse204 · No content

List payees in this household whose vector embedding is near-duplicate of :payeeId (cosine similarity >= 0.9).

GET/households/{householdId}/payees/{payeeId}/dedupe-candidates

read:payees

Paramètres

Nom	Emplacement	Requis
payeeId	path	Requis

Exemple de requête

bash

curl -H "Authorization: Bearer vokse_sk_…" \     -X GET https://api.vokse.ai/households/current/payees/{payeeId}/dedupe-candidates

Réponse200 · Success

Merge this payee into another: reassign transactions, dedupe aliases, soft-delete source

POST/households/{householdId}/payees/{payeeId}/merge

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	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/payees/{payeeId}/merge

Réponse200 · Success

Undo a merge: resurrect this (soft-deleted) payee and move the listed transactions back from the target

POST/households/{householdId}/payees/{payeeId}/unmerge

write:payees

Paramètres

Nom	Emplacement	Requis
payeeId	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/payees/{payeeId}/unmerge

Réponse200 · Success

Household-wide near-duplicate payee clusters (vector cosine >= 0.9), for the duplicates review tray.

GET/households/{householdId}/payees/duplicate-groups

read:payees

Exemple de requête

bash

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

Réponse200 · Success

Search, filter, sort and paginate the payee register

GET/households/{householdId}/payees/page

read:payees

Paramètres

Nom	Emplacement	Requis
sort	query	Optionnel
categoryId	query	Optionnel
segment	query	Optionnel
q	query	Optionnel
pageSize	query	Optionnel
page	query	Optionnel

Exemple de requête

bash

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

Réponse200 · Success