Skip to content
API Reference/
/
Get cash transaction

Fondo Partner API (2.0.0)

Overview

This API is intended for registered partners in agreement with Fondo.

The API is subject to change.

Download OpenAPI description
api_3.0.3.json
api_3.0.3.yaml
Overview
E-mail
tech@fondo.se
License
Proprietary
Languages
Servers
Mock server
https://docs.fondo.se/_mock/openapi/api_3.0.3
Production
https://api.fondo.se
Sandbox
https://api.sandbox.fondo.se

Authorization

Obtain and manage access tokens via OAuth 2.0 Client Credentials. Send grant_type=client_credentials with your client_id and client_secret. Use the returned access_token in Authorization: Bearer <token>. Tokens are short-lived—reuse during validity and renew on expiry.

Operations

Accounts

Accounts hold investor positions, balances, and cash movements under a client. Endpoints let you list accounts, fetch details, and close accounts. Responses include status, owner info, currency, linked bank accounts, positions, and timestamps.

Operations

Agreements

Retrieve account agreements and generate PDF documents for account-related contracts.

Operations

AllocationPlan

Allocation plans

Operations

Clients

A client is your legal entity (B2B) or grouping for end-investor accounts. Use these endpoints to list, create, read, and update clients, manage bank accounts and service types, and fetch client-specific resources (instruments, custodians).

Operations

Custodians

Fetch custodians linked to a client—useful for transfer instructions and operational routing. Returns identifiers and names for display and validation.

Operations

Journeys (Hosted Flows)

Journeys are secure, hosted web flows for customer interactions: account opening (e-sign), KYC/KYB questionnaires, fund transfers, and allocation plan setup. Create a Journey via API, redirect customers to the time-limited URL, and poll/callback for results.

Operations

Instruments

The instrument universe consists of mutual funds available for a given client or globally. Retrieve instrument metadata: identifiers (e.g., ISIN), currency, latest price, KIID links, tradability flags, unit decimals, minimums, and cost/fee breakdowns.

Operations

Payment Instructions

Payment instructions (e.g., autogiro) batch one or more payments to accounts. Create instructions, then track the payments under each instruction (amounts, status, and references).

Operations

Orders

Fund orders (subscription/redemption) drive the trading lifecycle. Create, read, list, and cancel orders; track status from received → sent → confirmed → settled. Orders reference accounts and instruments, and map to cash/fund transactions on settlement.

Operations

Transactions

Transactions record movements of money and units.

  • Cash transactions (CT): deposits, withdrawals, cash legs of fund orders (with settlement dates).
  • Fund transactions (FT): unit movements from subscriptions/redemptions (trade & settlement dates). Use these endpoints to reconcile ledgers and statements.
Operations

List cash transactions

Request

Returns every cash movement across all accounts belonging to the specified client_id. Each transaction includes its id, transactionType (e.g. deposit, withdrawal, or cash leg of a fund order), linked references (ref, refType, clientRef, executorRef), debit and credit accounts, monetary details (amount, currency), and full lifecycle timestamps (createdDate, modifiedDate, settlementDate). Use this endpoint to audit or reconcile every cash inflow and outflow associated with the client.

Security
oAuth
Path
client_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested client.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
Query
startstring

The sortedId to start from. Use for pagination.

Example: start=20240101abcdef
limitnumber

Limit results. Default is none

Example: limit=100
modifiedFromstring(date-time)

The modifiedDate to start from. Use for reconciliation.

Example: modifiedFrom=2024-01-01T00:00:01.000Z
refstring

Match transactions to this ref

Example: ref=de9b6d5e-bda0-44f6-9193-f241014f18d5
reftypestring

Match transactions refType to this reftype

Example: reftype=subscription
curl -i -X GET \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/cash?start=20240101abcdef&limit=100&modifiedFrom=2024-01-01T00%3A00%3A01.000Z&ref=de9b6d5e-bda0-44f6-9193-f241014f18d5&reftype=subscription' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Array of cash transactions

Bodyapplication/jsonArray [
idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-only

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
transactionTypedeposit (string) or fxFee (string) or withdrawal (string) or transfer_in (string) or transfer_out (string) or subscription (string) or redemption (string) or retrocession (string)required

Account type

One of:

Deposit of cash to account

string(deposit)
Value"deposit"
abortedboolean

Transaction has been aborted.

Default false
abortedReasonstring

Error code or freetext explaining abort

Example: "referenced_order_canceled"
refstring<= 255 characters

Transaction reference. External id. 255 chars.

refTypetext (string) or order (string) or payment (string) or ca (string) or internal (string) or external (string) or client_fee_oneoff (string) or client_fee_ongoing (string) or client_fee_transaction (string) or client_fee_performance (string) or client_fee_other (string)

The type of reference. Text or object Id

One of:

Text reference

string(text)
Value"text"
creditAccountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
debitAccountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
amountnumberrequired

Transaction amount as a number

Example: 1.2
currencystring^[A-Z]{3}$required

Three letter ISO currency code

Default "SEK"
Value"SEK"
Example: "SEK"
executorRefstring(executor reference)

Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client

Example: "197001010003"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
freetextstring

Free text of transaction

Example: "Hello world"
instrumentstring

Id of instrument if it is a transaction related to a specific instrument but not an order, ie retrocession

Example: "SE0012193019SEK"
startDatestring(date)

If a transaction is regarding a period of time

endDatestring(date)

If a transaction is regarding a period of time

createdDatestring(date-time)read-only

Date when transaction was created

Example: "2018-12-13t23:59:00.001z"
modifiedDatestring(date-time)read-only

Date when last modified

Example: "2018-12-13t23:59:00.001z"
settlementDatestring(date-time)read-only

Date when transaction was settled, null if not settled

Example: "2018-12-13t23:59:00.001z"
]
Response
application/json
[
  {
    "id": "string",
    "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "transactionType": "deposit",
    "aborted": false,
    "abortedReason": "referenced_order_canceled",
    "ref": "string",
    "refType": "text",
    "creditAccount": "string",
    "debitAccount": "string",
    "amount": 1.2,
    "currency": "SEK",
    "executorRef": "197001010003",
    "clientRef": "my_order_123",
    "freetext": "Hello world",
    "instrument": "SE0012193019SEK",
    "startDate": "2019-08-24",
    "endDate": "2019-08-24",
    "createdDate": "2018-12-13t23:59:00.001z",
    "modifiedDate": "2018-12-13t23:59:00.001z",
    "settlementDate": "2018-12-13t23:59:00.001z"
  }
]

Get cash transaction

Request

Returns the full record of a single cash movement identified by transaction_id for the given client_id. The response provides all key properties—transactionType (deposit, withdrawal, or cash leg of a fund order), linked references (ref, refType, clientRef, executorRef), debit and credit accounts, amount, currency, optional free text, and full lifecycle timestamps (createdDate, modifiedDate, settlementDate). Use this endpoint to inspect or audit an individual cash transaction in detail.

Security
oAuth
Path
client_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested client.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
transaction_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested transaction.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
curl -i -X GET \
  https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/cash/49ad7378-121c-4a53-9894-dfd14a7b4877 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Cash transaction

Bodyapplication/json
idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-only

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
transactionTypedeposit (string) or fxFee (string) or withdrawal (string) or transfer_in (string) or transfer_out (string) or subscription (string) or redemption (string) or retrocession (string)required

Account type

One of:

Deposit of cash to account

string(deposit)
Value"deposit"
abortedboolean

Transaction has been aborted.

Default false
abortedReasonstring

Error code or freetext explaining abort

Example: "referenced_order_canceled"
refstring<= 255 characters

Transaction reference. External id. 255 chars.

refTypetext (string) or order (string) or payment (string) or ca (string) or internal (string) or external (string) or client_fee_oneoff (string) or client_fee_ongoing (string) or client_fee_transaction (string) or client_fee_performance (string) or client_fee_other (string)

The type of reference. Text or object Id

One of:

Text reference

string(text)
Value"text"
creditAccountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
debitAccountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
amountnumberrequired

Transaction amount as a number

Example: 1.2
currencystring^[A-Z]{3}$required

Three letter ISO currency code

Default "SEK"
Value"SEK"
Example: "SEK"
executorRefstring(executor reference)

Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client

Example: "197001010003"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
freetextstring

Free text of transaction

Example: "Hello world"
instrumentstring

Id of instrument if it is a transaction related to a specific instrument but not an order, ie retrocession

Example: "SE0012193019SEK"
startDatestring(date)

If a transaction is regarding a period of time

endDatestring(date)

If a transaction is regarding a period of time

createdDatestring(date-time)read-only

Date when transaction was created

Example: "2018-12-13t23:59:00.001z"
modifiedDatestring(date-time)read-only

Date when last modified

Example: "2018-12-13t23:59:00.001z"
settlementDatestring(date-time)read-only

Date when transaction was settled, null if not settled

Example: "2018-12-13t23:59:00.001z"
Response
application/json
{
  "id": "string",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "transactionType": "deposit",
  "aborted": false,
  "abortedReason": "referenced_order_canceled",
  "ref": "string",
  "refType": "text",
  "creditAccount": "string",
  "debitAccount": "string",
  "amount": 1.2,
  "currency": "SEK",
  "executorRef": "197001010003",
  "clientRef": "my_order_123",
  "freetext": "Hello world",
  "instrument": "SE0012193019SEK",
  "startDate": "2019-08-24",
  "endDate": "2019-08-24",
  "createdDate": "2018-12-13t23:59:00.001z",
  "modifiedDate": "2018-12-13t23:59:00.001z",
  "settlementDate": "2018-12-13t23:59:00.001z"
}

List fund transactions

Request

Returns every fund‐unit movement across the accounts of the specified client_id, including both subscriptions and redemptions. Each transaction details its transactionType (e.g. subscription, redemption), linked references (ref, refType, clientRef, executorRef), target account, instrument identifiers, number of units, executed price, currency, and full lifecycle timestamps (createdDate, modifiedDate, tradeDate, settlementDate). Use this endpoint to audit or reconcile all fund‐unit inflows and outflows associated with the client.

Security
oAuth
Path
client_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested client.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
Query
startstring

The sortedId to start from. Use for pagination.

Example: start=20240101abcdef
limitnumber

Limit results. Default is none

Example: limit=100
modifiedFromstring(date-time)

The modifiedDate to start from. Use for reconciliation.

Example: modifiedFrom=2024-01-01T00:00:01.000Z
refstring

Match transactions to this ref

Example: ref=de9b6d5e-bda0-44f6-9193-f241014f18d5
reftypestring

Match transactions refType to this reftype

Example: reftype=subscription
curl -i -X GET \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/fund?start=20240101abcdef&limit=100&modifiedFrom=2024-01-01T00%3A00%3A01.000Z&ref=de9b6d5e-bda0-44f6-9193-f241014f18d5&reftype=subscription' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Array of fund transactions

Bodyapplication/jsonArray [
idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-only

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
transactionTyperedemption (string) or subscription (string) or transfer_in (string) or transfer_out (string)required

Fund transaction type

One of:

Units of a redemption order

string(redemption)
Value"redemption"
abortedboolean

Transaction has been aborted.

Default false
abortedReasonstring

Error code or freetext explaining abort

Example: "referenced_order_canceled"
refstring

Reference ID of the object that caused the transaction (order, ca etc)

refTypestring

Type that caused the transaction

Enum"order""ca""internal""external""gift""compensations""inheritance""dividend""endowment_101"
accountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...required

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
instrumentstringrequired

Fondo instrument ID

Example: "SE0012193019SEK"
identifierstringrequired

ISIN code of fund instrument

Example: "SE0012193019"
unitsnumberrequired

Transaction fund units

pricenumber

Transaction price per unit (NAV)

currencystring^[A-Z]{3}$required

Three letter ISO currency code of transaction

Example: "SEK"
freetextstring

Free text of transaction

Example: "Hello world"
executorRefstring(executor reference)

Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client

Example: "197001010003"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
createdDatestring(date-time)read-only

date when created

Example: "2018-12-13T23:59:00.001Z"
modifiedDatestring(date-time)read-only

Date when last modified

Example: "2018-12-13T23:59:00.001Z"
settlementDatestring or null(date-time)read-only

Date when transaction was settled, null if not settled

Example: "2018-12-13T23:59:00.001Z"
tradeDatestring or null(date-time)read-only

Trade date (date of pricing)

Example: "2018-12-13T23:59:00.001Z"
]
Response
application/json
[
  {
    "id": "string",
    "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "transactionType": "redemption",
    "aborted": false,
    "abortedReason": "referenced_order_canceled",
    "ref": "string",
    "refType": "order",
    "account": "string",
    "instrument": "SE0012193019SEK",
    "identifier": "SE0012193019",
    "units": 0,
    "price": 0,
    "currency": "SEK",
    "freetext": "Hello world",
    "executorRef": "197001010003",
    "clientRef": "my_order_123",
    "createdDate": "2018-12-13T23:59:00.001Z",
    "modifiedDate": "2018-12-13T23:59:00.001Z",
    "settlementDate": "2018-12-13T23:59:00.001Z",
    "tradeDate": "2018-12-13T23:59:00.001Z"
  }
]

Get fund transaction

Request

Returns the complete record of a single fund‐unit movement identified by transaction_id for the given client_id. The response includes the transactionType (subscription or redemption), related references (ref, refType, clientRef, executorRef), account and instrument identifiers, number of units, executed price, currency, and full lifecycle timestamps (createdDate, modifiedDate, tradeDate, settlementDate). Use this endpoint to inspect or audit an individual subscription or redemption transaction.

Security
oAuth
Path
client_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested client.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
transaction_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested transaction.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
curl -i -X GET \
  https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/fund/49ad7378-121c-4a53-9894-dfd14a7b4877 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Fund transaction

Bodyapplication/json
idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-only

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
transactionTyperedemption (string) or subscription (string) or transfer_in (string) or transfer_out (string)required

Fund transaction type

One of:

Units of a redemption order

string(redemption)
Value"redemption"
abortedboolean

Transaction has been aborted.

Default false
abortedReasonstring

Error code or freetext explaining abort

Example: "referenced_order_canceled"
refstring

Reference ID of the object that caused the transaction (order, ca etc)

refTypestring

Type that caused the transaction

Enum"order""ca""internal""external""gift""compensations""inheritance""dividend""endowment_101"
accountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...required

UUID (Universally Unique Identifier)

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
instrumentstringrequired

Fondo instrument ID

Example: "SE0012193019SEK"
identifierstringrequired

ISIN code of fund instrument

Example: "SE0012193019"
unitsnumberrequired

Transaction fund units

pricenumber

Transaction price per unit (NAV)

currencystring^[A-Z]{3}$required

Three letter ISO currency code of transaction

Example: "SEK"
freetextstring

Free text of transaction

Example: "Hello world"
executorRefstring(executor reference)

Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client

Example: "197001010003"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
createdDatestring(date-time)read-only

date when created

Example: "2018-12-13T23:59:00.001Z"
modifiedDatestring(date-time)read-only

Date when last modified

Example: "2018-12-13T23:59:00.001Z"
settlementDatestring or null(date-time)read-only

Date when transaction was settled, null if not settled

Example: "2018-12-13T23:59:00.001Z"
tradeDatestring or null(date-time)read-only

Trade date (date of pricing)

Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "string",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "transactionType": "redemption",
  "aborted": false,
  "abortedReason": "referenced_order_canceled",
  "ref": "string",
  "refType": "order",
  "account": "string",
  "instrument": "SE0012193019SEK",
  "identifier": "SE0012193019",
  "units": 0,
  "price": 0,
  "currency": "SEK",
  "freetext": "Hello world",
  "executorRef": "197001010003",
  "clientRef": "my_order_123",
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "settlementDate": "2018-12-13T23:59:00.001Z",
  "tradeDate": "2018-12-13T23:59:00.001Z"
}

Subscriptions (WebSocket & Webhooks)

Receive real-time updates from Fondo without polling.

  • WebSocket: open a persistent stream for .create, .update, .delete, and heartbeat events.
  • Webhooks: register a callback URL to get signed POSTs with current/previous payloads. Include replay/retry handling in your consumers.
Operations

System

API Service functions

Operations
© 2026 Fondo Solutions. All rights reserved.