Skip to content
API Reference/
/
Create withdrawal

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

List client's accounts

Request

Returns every investment account linked to client_id, including identifiers, type, status, balances, positions, linked bank accounts, currency, and timestamps. Use this to display or manage the client's full account set.

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
ssnstring(19|20)[0-9]{2}[0-9]{2}[0-9]{4}

The social security number of account owner

curl -i -X GET \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account?start=20240101abcdef&limit=100&modifiedFrom=2024-01-01T00%3A00%3A01.000Z&ssn=string' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Array of accounts

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"
refstring<= 128 characters

ref is a unique account number, based on epoch, length and Luhn. OCR /w length digit compliant.

Example: "160367146695159"
namestringrequired

Name of account

Example: "Spar"
statusstring

Status of account

Enum"pending""active""rejected""confirm"
accountTypeisk (string) or depot (string) or insurance (string)required

Account type

One of:

ISK, investeringssparkonto

string(isk)
Value"isk"
serviceTypeportfolioManagement (string) or investmentAdvise (string) or executionOnly (string)(accountServiceType)required

Account service type

One of:

Portfolio management

string(portfolioManagement)
Value"portfolioManagement"
ownerobject
balancenumber

Snapshot of cash amount on account

Example: 100
amountsobject

Amounts on account

positionsArray of objects

List of positions held

deletedbooleanrequired

Is account deleted?

clientIdstring(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"
bankAccountsArray of objects(paymentAccount)
currencystring^[A-Z]{3}$required

Three letter ISO currency code

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

Date when acocunt 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"
deletedDatestring(date-time)read-only

Date when flagged as deleted

Example: "2018-12-13T23:59:00.001Z"
]
Response
application/json
[
  {
    "id": "string",
    "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "ref": "160367146695159",
    "name": "Spar",
    "status": "pending",
    "accountType": "isk",
    "serviceType": "portfolioManagement",
    "owner": { … },
    "balance": 100,
    "amounts": { … },
    "positions": [ … ],
    "deleted": true,
    "clientId": "string",
    "bankAccounts": [ … ],
    "currency": "SEK",
    "createdDate": "2018-12-13T23:59:00.001Z",
    "modifiedDate": "2018-12-13T23:59:00.001Z",
    "deletedDate": "2018-12-13T23:59:00.001Z"
  }
]

Get kyc status

Request

Get status of kyc

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

The ID of requested account.

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

Responses

Status of kyc

Bodyapplication/json
orderboolean

are all expected kycs completed for orders to be allowed?

withdrawalboolean

are all expected kycs completed for withdrawals to be allowed?

Response
application/json
{
  "order": true,
  "withdrawal": true
}

Get account

Request

Returns the full record for account_id under client_id, including identifiers, status, account and service type, owner details, balances and cumulative amounts, current positions, linked bank accounts, currency, and timestamps. Use this to display or verify a single investment account and its latest state.

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

The ID of requested account.

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

Responses

Account

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"
refstring<= 128 characters

ref is a unique account number, based on epoch, length and Luhn. OCR /w length digit compliant.

Example: "160367146695159"
namestringrequired

Name of account

Example: "Spar"
statusstring

Status of account

Enum"pending""active""rejected""confirm"
accountTypeisk (string) or depot (string) or insurance (string)required

Account type

One of:

ISK, investeringssparkonto

string(isk)
Value"isk"
serviceTypeportfolioManagement (string) or investmentAdvise (string) or executionOnly (string)(accountServiceType)required

Account service type

One of:

Portfolio management

string(portfolioManagement)
Value"portfolioManagement"
ownerobject
balancenumber

Snapshot of cash amount on account

Example: 100
amountsobject

Amounts on account

positionsArray of objects

List of positions held

deletedbooleanrequired

Is account deleted?

clientIdstring(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"
bankAccountsArray of objects(paymentAccount)
currencystring^[A-Z]{3}$required

Three letter ISO currency code

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

Date when acocunt 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"
deletedDatestring(date-time)read-only

Date when flagged as deleted

Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "string",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "ref": "160367146695159",
  "name": "Spar",
  "status": "pending",
  "accountType": "isk",
  "serviceType": "portfolioManagement",
  "owner": {
    "firstName": "Ben",
    "lastName": "Rangel",
    "fullName": "Ben Rangel",
    "ssn": "197001010003"
  },
  "balance": 100,
  "amounts": {
    "deposited": 123.45,
    "withdrawn": 123.45
  },
  "positions": [
    { … }
  ],
  "deleted": true,
  "clientId": "string",
  "bankAccounts": [
    { … }
  ],
  "currency": "SEK",
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "deletedDate": "2018-12-13T23:59:00.001Z"
}

Close client account

Request

Marks the account account_id (under client_id) as closed so no new activity can occur. The response echoes the account record including deleted/closed state. Historical data remains available for regulatory/reporting needs.

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

The ID of requested account.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
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
curl -i -X DELETE \
  https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account/49ad7378-121c-4a53-9894-dfd14a7b4877 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Account

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"
refstring<= 128 characters

ref is a unique account number, based on epoch, length and Luhn. OCR /w length digit compliant.

Example: "160367146695159"
namestringrequired

Name of account

Example: "Spar"
statusstring

Status of account

Enum"pending""active""rejected""confirm"
accountTypeisk (string) or depot (string) or insurance (string)required

Account type

One of:

ISK, investeringssparkonto

string(isk)
Value"isk"
serviceTypeportfolioManagement (string) or investmentAdvise (string) or executionOnly (string)(accountServiceType)required

Account service type

One of:

Portfolio management

string(portfolioManagement)
Value"portfolioManagement"
ownerobject
balancenumber

Snapshot of cash amount on account

Example: 100
amountsobject

Amounts on account

positionsArray of objects

List of positions held

deletedbooleanrequired

Is account deleted?

clientIdstring(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"
bankAccountsArray of objects(paymentAccount)
currencystring^[A-Z]{3}$required

Three letter ISO currency code

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

Date when acocunt 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"
deletedDatestring(date-time)read-only

Date when flagged as deleted

Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "string",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "ref": "160367146695159",
  "name": "Spar",
  "status": "pending",
  "accountType": "isk",
  "serviceType": "portfolioManagement",
  "owner": {
    "firstName": "Ben",
    "lastName": "Rangel",
    "fullName": "Ben Rangel",
    "ssn": "197001010003"
  },
  "balance": 100,
  "amounts": {
    "deposited": 123.45,
    "withdrawn": 123.45
  },
  "positions": [
    { … }
  ],
  "deleted": true,
  "clientId": "string",
  "bankAccounts": [
    { … }
  ],
  "currency": "SEK",
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "deletedDate": "2018-12-13T23:59:00.001Z"
}

List cash transactions

Request

Returns the cash ledger for account_id (under client_id), including transaction type (e.g., deposit/withdrawal/settlement/fee), references, accounts debited/credited, amount/currency, dates (createdDate, modifiedDate, settlementDate), and optional client/executor references. Use for cash reconciliation and statements.

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
account_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested account.

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
curl -i -X GET \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/cash?start=20240101abcdef&limit=100&modifiedFrom=2024-01-01T00%3A00%3A01.000Z' \
  -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"
  }
]

List fund transactions

Request

Returns fund activity for account_id (under client_id) such as subscriptions/redemptions with instrument identifiers, units, price, currency, references, and key dates (tradeDate, settlementDate). Use to build position histories and confirm settled/unspecified units.

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
account_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested account.

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
curl -i -X GET \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account/49ad7378-121c-4a53-9894-dfd14a7b4877/transaction/fund?start=20240101abcdef&limit=100&modifiedFrom=2024-01-01T00%3A00%3A01.000Z' \
  -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"
  }
]

Create withdrawal

Request

Initiates a payout from account_id (under client_id). Provide withdrawal details (e.g., withdrawalType, target bankAccount) in the request body. The response returns the created transaction with identifiers, amounts, and settlement metadata for tracking.

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
account_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested account.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
Bodyapplication/json

Withdrawal request

One of:

Payout to customers bank account

withdrawalTypestring(bank_payout)required

Payout to customers bank account

Value"bank_payout"
bankAccountstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...required

ID of bank account from account schema

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
executorRefstring(executor reference)required

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

Reference should be SSN of the individual client

Example: "197001010003"
amountnumberrequired

Transaction amount

curl -i -X POST \
  https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account/49ad7378-121c-4a53-9894-dfd14a7b4877/withdrawal \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "withdrawalType": "bank_payout",
    "bankAccount": "string",
    "clientRef": "my_order_123",
    "executorRef": "197001010003",
    "amount": 0
  }'

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

Get Swish deposit status

Request

Returns the current status of a previously initiated Swish deposit session. Use to confirm whether the deposit is pending or successfully paid; errorCode provides additional context if applicable.

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

The swish ID returned from swish deposit session

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

Responses

Swish deposit session status

Bodyapplication/json
statusstring

status from swish

Example: "PAID"
errorCodestring or null

error code from swish

Example: "AM02"
Response
application/json
{
  "status": "PAID",
  "errorCode": "AM02"
}

Create Swish deposit

Request

Starts a new Swish payment session for account_id (under client_id). Send details like type (e.g., same_device), amount, and optional qrFormat. The response includes a session id, token, optional qrImage, and a paymentId to track the flow through status checks.

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
account_idstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-onlyrequired

The ID of requested account.

Example: 49ad7378-121c-4a53-9894-dfd14a7b4877
Bodyapplication/json

Swish deposit

curl -i -X POST \
  https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/account/49ad7378-121c-4a53-9894-dfd14a7b4877/deposit/swish \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "same_device",
    "clientRef": "string",
    "amount": 0
  }'

Responses

Swish deposit session information

Bodyapplication/json
idstring

id of swish payment. Use to get status of signature

tokenstring

swish token. Used to start bankid app on same devie

qrImagestring

swish qr image. Provided only if type set to qr

paymentIdstring(UUID)^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...read-only

id of corresponding payment object

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
Response
application/json
{
  "id": "string",
  "token": "string",
  "qrImage": "string",
  "paymentId": "string"
}

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

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.