Sfoglia il riferimento

Beneficiari

13 endpoint · Le descrizioni degli endpoint sono in inglese.

List payees in this household

GET/households/{householdId}/payees

read:payees

Richiesta di esempio

bash

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

Risposta200 · Success

Create a payee

POST/households/{householdId}/payees

write:payees

Corpo della richiesta

json

{  "name": "Local supermarket"}

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

Risposta201 · Success

Get a payee

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

read:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

Update a payee (recomputes normalized_name on rename)

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

write:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Corpo della richiesta

json

{  "name": "Whole Foods"}

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

Risposta200 · Success

Soft-delete a payee

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

write:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · No content

List aliases of a payee

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

read:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

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

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

write:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta201 · Success

Remove an alias

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

write:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio
aliasId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta204 · 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

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

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

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

write:payees

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · 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

Parametri

Nome	Posizione	Obbligatorio
payeeId	path	Obbligatorio

Richiesta di esempio

bash

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

Risposta200 · Success

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

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

read:payees

Richiesta di esempio

bash

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

Risposta200 · Success

Search, filter, sort and paginate the payee register

GET/households/{householdId}/payees/page

read:payees

Parametri

Nome	Posizione	Obbligatorio
sort	query	Facoltativo
categoryId	query	Facoltativo
segment	query	Facoltativo
q	query	Facoltativo
pageSize	query	Facoltativo
page	query	Facoltativo

Richiesta di esempio

bash

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

Risposta200 · Success