In der Referenz stöbern

Zahlungsempfänger

13 Endpunkte · Die Endpunktbeschreibungen sind auf Englisch.

List payees in this household

GET/households/{householdId}/payees

read:payees

Beispielanfrage

bash

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

Antwort200 · Success

Create a payee

POST/households/{householdId}/payees

write:payees

Request-Body

json

{  "name": "Local supermarket"}

Beispielanfrage

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

Antwort201 · Success

Get a payee

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

read:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

Update a payee (recomputes normalized_name on rename)

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

write:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Request-Body

json

{  "name": "Whole Foods"}

Beispielanfrage

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

Antwort200 · Success

Soft-delete a payee

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

write:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort204 · No content

List aliases of a payee

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

read:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

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

write:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort201 · Success

Remove an alias

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

write:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich
aliasId	path	Erforderlich

Beispielanfrage

bash

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

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

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

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

write:payees

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

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

Parameter

Name	Ort	Erforderlich
payeeId	path	Erforderlich

Beispielanfrage

bash

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

Antwort200 · Success

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

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

read:payees

Beispielanfrage

bash

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

Antwort200 · Success

Search, filter, sort and paginate the payee register

GET/households/{householdId}/payees/page

read:payees

Parameter

Name	Ort	Erforderlich
sort	query	Optional
categoryId	query	Optional
segment	query	Optional
q	query	Optional
pageSize	query	Optional
page	query	Optional

Beispielanfrage

bash

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

Antwort200 · Success