Legacy (v1-compat)

Create a finance transaction on an entry (entryId required -- transactions are entry-scoped in v2)

post/groups/{groupId}/finance/transactions

Request

  • Base URL: https://whatareyoudo.ing/api/v1
  • URL: https://whatareyoudo.ing/api/v1/groups/{groupId}/finance/transactions
  • Auth: HTTP bearer

Path parameters

groupIdstring uuid required

Request body

type'income' | 'expense' | 'transfer' required
amountnumber required
amountMinorstring

issue #63: exact alternative to amount -- wins when present

sourceAssetIdstring uuid nullable
destAssetIdstring uuid nullable
payeestring nullable
shopstring nullable
shopIdstring uuid nullable
categoryIdstring uuid nullable
entryIdstring uuid nullable
descriptionstring
occurredAtstring
occurredTimestring nullable
tagsstring[]
receiptKeysstring[]

Response

Created

idstring required
type'income' | 'expense' | 'transfer' required
amountnumber required
amount_minorstring required

issue #63: exact integer minor-units mirror of amount

currencystring required

What amount and fee_amount are in: the accounts' currency (ISO 4217).

source_asset_idstring uuid nullable required
dest_asset_idstring uuid nullable required
payeestring nullable required
shopstring nullable required
shop_idstring uuid nullable required
category_idstring uuid nullable required
entry_idstring uuid required
descriptionstring required
occurred_atstring required
occurred_timestring nullable required
tagsstring[] required
fee_amountnumber required
fee_amount_minorstring required

issue #63: exact integer minor-units mirror of fee_amount

fee_payer'sender' | 'receiver' | 'split' required
source_debit_amountnumber nullable required
dest_credit_amountnumber nullable required

Changes

No recorded changes to this operation across all 6 revisions of this API.