Explorar la referencia

Beneficiarios

13 endpoints · Las descripciones de los endpoints están en inglés.

List payees in this household

GET/households/{householdId}/payees

read:payees

Ejemplo de petición

bash

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

Respuesta200 · Success

Create a payee

POST/households/{householdId}/payees

write:payees

Cuerpo de la petición

json

{  "name": "Local supermarket"}

Ejemplo de petición

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

Respuesta201 · Success

Get a payee

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

read:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

Update a payee (recomputes normalized_name on rename)

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

write:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Cuerpo de la petición

json

{  "name": "Whole Foods"}

Ejemplo de petición

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

Respuesta200 · Success

Soft-delete a payee

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

write:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta204 · No content

List aliases of a payee

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

read:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

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

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

write:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta201 · Success

Remove an alias

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

write:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio
aliasId	path	Obligatorio

Ejemplo de petición

bash

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

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

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

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

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

write:payees

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

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

Parámetros

Nombre	En	Obligatorio
payeeId	path	Obligatorio

Ejemplo de petición

bash

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

Respuesta200 · Success

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

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

read:payees

Ejemplo de petición

bash

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

Respuesta200 · Success

Search, filter, sort and paginate the payee register

GET/households/{householdId}/payees/page

read:payees

Parámetros

Nombre	En	Obligatorio
sort	query	Opcional
categoryId	query	Opcional
segment	query	Opcional
q	query	Opcional
pageSize	query	Opcional
page	query	Opcional

Ejemplo de petición

bash

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

Respuesta200 · Success