Skip to content
API Reference/
/
Create order 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

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

Create order withdrawal

Request

Sell fund units and withdraw the resulting amount

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
validate-onlystring

Only validate the order, do not create it.

Example: validate-only=true
Bodyapplication/json

An order request

orderTypeanyrequired
Value"redemption"
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"
clientRefstring

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

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals

Example: 1000
bankAccountstring(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"
paymentAccountstring(UUID)Deprecated^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...

Payment account ID to create bank payout for. Deprecated: Use bankAccount instead.

Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
curl -i -X POST \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/order/withdrawal?validate-only=true' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderType": "redemption",
    "account": "string",
    "clientRef": "my_order_123",
    "executorRef": "197001010003",
    "instrument": "US64110L1061USD",
    "units": 1000,
    "paymentAccount": "string",
    "bankAccount": "string"
  }'

Responses

Order

Bodyapplication/json
idstring(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"
statusreceived (string) or pending (string) or sent (string) or settled (string) or canceled (string) or hold (string)(order status)

Order status

One of:

Received by the system.

string(received)
Value"received"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
orderTypeanyrequired
Enum"subscription""redemption"
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"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
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"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals. Required for redemption orders.

Example: 1000
amountnumberrequired

For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.

Example: 100
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"
canceledDatestring(date-time)read-only

Date when canceled

Default null
Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
  "status": "received",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "orderType": "subscription",
  "account": "string",
  "clientRef": "my_order_123",
  "executorRef": "197001010003",
  "instrument": "US64110L1061USD",
  "units": 1000,
  "amount": 100,
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "canceledDate": "2018-12-13T23:59:00.001Z"
}

List orders

Request

Returns every order placed under client_id, including both subscriptions and redemptions. Each order object provides its id, orderType, current status (e.g., received, sent, confirmed, settled), associated account, references (clientRef, executorRef), the targeted instrument, requested units or amount, and full lifecycle timestamps (createdDate, modifiedDate, canceledDate). Use this endpoint to monitor all fund orders and their progress from initiation through settlement.

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

Responses

Array of orders

Bodyapplication/jsonArray [
idstring(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"
statusreceived (string) or pending (string) or sent (string) or settled (string) or canceled (string) or hold (string)(order status)

Order status

One of:

Received by the system.

string(received)
Value"received"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
orderTypeanyrequired
Enum"subscription""redemption"
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"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
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"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals. Required for redemption orders.

Example: 1000
amountnumberrequired

For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.

Example: 100
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"
canceledDatestring(date-time)read-only

Date when canceled

Default null
Example: "2018-12-13T23:59:00.001Z"
]
Response
application/json
[
  {
    "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
    "status": "received",
    "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "orderType": "subscription",
    "account": "string",
    "clientRef": "my_order_123",
    "executorRef": "197001010003",
    "instrument": "US64110L1061USD",
    "units": 1000,
    "amount": 100,
    "createdDate": "2018-12-13T23:59:00.001Z",
    "modifiedDate": "2018-12-13T23:59:00.001Z",
    "canceledDate": "2018-12-13T23:59:00.001Z"
  }
]

Create order

Request

Creates a new fund order (subscription or redemption) on the account specified by account under the given client_id. Provide details such as orderType, instrument, amount or units, and optional references (clientRef, executorRef) to help track the order. The response includes the generated order id, its initial status (typically received), and full order details for monitoring as it moves through execution and settlement.

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
validate-onlystring

Only validate the order, do not create it.

Example: validate-only=true
Bodyapplication/json

An order request

One of:

subscription order

orderTypeanyrequired
Value"subscription"
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"
clientRefstring

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

Fondo instrument ID

Example: "US64110L1061USD"
amountnumberrequired

The amount to subscribe for.

Example: 100
curl -i -X POST \
  'https://docs.fondo.se/_mock/openapi/api_3.0.3/v2/partner/client/49ad7378-121c-4a53-9894-dfd14a7b4877/order?validate-only=true' \
  -H 'Authorization: Bearer <YOUR_Token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "orderType": "subscription",
    "account": "string",
    "clientRef": "my_order_123",
    "executorRef": "197001010003",
    "instrument": "US64110L1061USD",
    "amount": 100
  }'

Responses

Order

Bodyapplication/json
idstring(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"
statusreceived (string) or pending (string) or sent (string) or settled (string) or canceled (string) or hold (string)(order status)

Order status

One of:

Received by the system.

string(received)
Value"received"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
orderTypeanyrequired
Enum"subscription""redemption"
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"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
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"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals. Required for redemption orders.

Example: 1000
amountnumberrequired

For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.

Example: 100
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"
canceledDatestring(date-time)read-only

Date when canceled

Default null
Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
  "status": "received",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "orderType": "subscription",
  "account": "string",
  "clientRef": "my_order_123",
  "executorRef": "197001010003",
  "instrument": "US64110L1061USD",
  "units": 1000,
  "amount": 100,
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "canceledDate": "2018-12-13T23:59:00.001Z"
}

Get order

Request

Returns the full details of a single order identified by order_id under the given client_id. The response includes the order's status (for example received, sent, confirmed, settled), orderType (subscription or redemption), associated account, instrument details, requested amount or units, and lifecycle timestamps (createdDate, modifiedDate, canceledDate). Use this endpoint to track an individual order's progress from initiation through settlement or cancellation.

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

The ID of requested order.

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/order/49ad7378-121c-4a53-9894-dfd14a7b4877 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Order

Bodyapplication/json
idstring(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"
statusreceived (string) or pending (string) or sent (string) or settled (string) or canceled (string) or hold (string)(order status)

Order status

One of:

Received by the system.

string(received)
Value"received"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
orderTypeanyrequired
Enum"subscription""redemption"
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"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
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"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals. Required for redemption orders.

Example: 1000
amountnumberrequired

For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.

Example: 100
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"
canceledDatestring(date-time)read-only

Date when canceled

Default null
Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
  "status": "received",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "orderType": "subscription",
  "account": "string",
  "clientRef": "my_order_123",
  "executorRef": "197001010003",
  "instrument": "US64110L1061USD",
  "units": 1000,
  "amount": 100,
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "canceledDate": "2018-12-13T23:59:00.001Z"
}

Cancel order

Request

Cancels the order identified by order_id for the given client_id. Use this endpoint to stop an order that has been created but not yet fully executed or settled. The response returns the complete order object with its status updated to canceled (if the cancellation succeeded), including all key fields such as orderType, instrument, and lifecycle timestamps.

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

The ID of requested order.

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/order/49ad7378-121c-4a53-9894-dfd14a7b4877 \
  -H 'Authorization: Bearer <YOUR_Token_HERE>'

Responses

Order

Bodyapplication/json
idstring(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"
statusreceived (string) or pending (string) or sent (string) or settled (string) or canceled (string) or hold (string)(order status)

Order status

One of:

Received by the system.

string(received)
Value"received"
sortedIdstring(ULID)^[0-9a-zA-Z]{26}$read-only

ULID (Universally Unique Lexicographically Sortable Identifier)

Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"
orderTypeanyrequired
Enum"subscription""redemption"
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"
clientRefstring(client reference)

Client applied ref

Example: "my_order_123"
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"
instrumentstringrequired

Fondo instrument ID

Example: "US64110L1061USD"
unitsnumberrequired

Number of units. 7 decimals. Required for redemption orders.

Example: 1000
amountnumberrequired

For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.

Example: 100
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"
canceledDatestring(date-time)read-only

Date when canceled

Default null
Example: "2018-12-13T23:59:00.001Z"
Response
application/json
{
  "id": "49ad7378-121c-4a53-9894-dfd14a7b4877",
  "status": "received",
  "sortedId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
  "orderType": "subscription",
  "account": "string",
  "clientRef": "my_order_123",
  "executorRef": "197001010003",
  "instrument": "US64110L1061USD",
  "units": 1000,
  "amount": 100,
  "createdDate": "2018-12-13T23:59:00.001Z",
  "modifiedDate": "2018-12-13T23:59:00.001Z",
  "canceledDate": "2018-12-13T23:59:00.001Z"
}

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.