Upsert transaction

Create a Transaction if none exists with the given Tracking ID, or update the existing one otherwise.

This is an idempotent operation: calling it twice with the same payload results in the same end state. Safe to retry on network failure, or to replay as part of a scheduled sync from your portfolio accounting system or fund administrator's monthly data.

Matching rule

The Transaction is matched by the trackingId you supply in the request body. trackingId is required — requests without a trackingId are rejected with a 400 Bad Request.

Response

The response always includes the full Transaction object plus a result field:

  • "result": "created" — no match was found, a new Transaction was created under the supplied investmentId.
  • "result": "updated" — an existing Transaction was found and its fields were updated.

Field semantics

FieldCreateUpdate
trackingIdRequired (match key).Required (match key).
nameRequired.Replace if present; omit = unchanged.
transactionTypeRequired.Replace if present; omit = unchanged.
investmentIdRequired.Ignored — Transactions are tied to their investment for life.
transactionAmountOptional. Without currency, the fund legal entity's default currency.Replace if present; omit or null = unchanged. Without currency, keeps the Transaction's current currency.
amount (deprecated; use transactionAmount)Optional. Saved in the fund legal entity's default currency.Replace if present, keeping the Transaction's current currency; omit or null = unchanged.
fundFeeId, effectiveDate, createdDate, noteOptional.Replace if present; omit = unchanged.

A transactionAmount object must have an amount. Sending both transactionAmount and amount is rejected. A supported currency the fund legal entity does not have yet is added to it.

Validation errors return 400 Bad Request with the offending field name.

Bulk upsert mode (caveat)

When using mode: "upsert" on the bulk POST /transactions/import endpoint, every per-row field is applied to the matched Transaction — there is no way to express "leave this field unchanged" within a single bulk row. Use the individual upsert endpoint above for partial updates.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the Firm object

Body Params
string

Anduin ID or Tracking ID of the parent investment. Required when creating a new transaction; ignored on update.

string
required

Customer-supplied Tracking ID used to match an existing Transaction.
If a Transaction with this Tracking ID already exists in the firm, it will be updated.
Otherwise, a new Transaction will be created with this Tracking ID. Required.

string

Required when creating a new Transaction. On update, omit to leave the name unchanged.

transactionType

Required when creating a new Transaction. On update, omit to leave unchanged; provide to replace the existing type.

string

The ID of Fund Fee object

string

The ID of Fund Share Class object

string

The ID of Fund Close object

number
deprecated

Deprecated; use transactionAmount. Will be removed on June 1, 2027. On create, saved in the fund legal entity's default currency; on update, keeps the Transaction's current currency, or uses the default currency when it has no amount, and null or omitting it leaves the amount unchanged. Send this field or transactionAmount, not both.

date
date
string
transactionAmount
object

Amount of the Transaction; the object must have an amount. Without currency: on create, the fund legal entity's default currency; on update, the Transaction's current currency, or the default currency when it has no amount. A supported currency the fund legal entity does not have yet is added to it. Changing the currency never converts the amount. On update, null or omitting it leaves the amount unchanged.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json