API status
  • Investments Solutions

Savings Plans

All savings plans related paths.

get

Retrieve a savings plan

Retrieve a savings plan specified by its ID.

savings_plan_idstring

required

Format
uuid

Responses

Response examples

OK

{
  "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
  "created_at": "2023-07-21T14:10:00.00Z",
  "updated_at": "2023-07-21T15:10:00.00Z",
  "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
  "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
  "name": "Instrument savings plan",
  "type": "INSTRUMENT",
  "instrument_id": "DE0007664005",
  "instrument_id_type": "ISIN",
  "cash_amount": "100.00",
  "currency": "EUR",
  "start_date": "2023-07-24",
  "period": "WEEK",
  "interval": 1,
  "status": "ACTIVE"
}
delete

Delete a savings plan

Delete a savings plan specified by its ID.

savings_plan_idstring

required

Format
uuid

Responses

Response examples

The request has been successfully accepted and will be processed asynchronously.

Empty response

get

List savings plans

List savings plans

account_idstring

Filters savings plans by account ID

Example
"3ada8e9e-82c4-4c78-a43d-a691b1636509"
user_idstring

Filters savings plans by user ID

Example
"996e5e2c-bb76-4a38-8d5c-ff43d86904da"
instrument_idOne Of

Filters savings plans by instrument ID (ISIN)

Example
"FR0010524777"

Must match one of

International securities identification number defined by ISO 6166.

Pattern
^[A-Z]{2}[A-Z0-9]{9}[0-9]$
sortstring

Sort the result by id.

Default
"id"
Enum
  • id
orderstring

Sort order of the result list if the sort parameter is specified. By default, only ASC for ascending sort.

Default
"ASC"
Enum
  • ASC
offsetint

Use the offset argument to specify where in the list of results to start when returning items for a particular query.

Format
int32
Min
0
limitint

Use the limit argument to specify the maximum number of items returned.

Format
int32
Default
100
Min
0
Max
1000

Responses

Response examples

OK

{
  "meta": {
    "offset": 0,
    "limit": 100,
    "count": 1,
    "total_count": 1,
    "sort": "id",
    "order": "ASC"
  },
  "data": [
    {
      "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
      "created_at": "2023-07-21T14:10:00.00Z",
      "updated_at": "2023-07-21T15:10:00.00Z",
      "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
      "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
      "name": "Instrument savings plan",
      "type": "INSTRUMENT",
      "instrument_id": "DE0007664005",
      "instrument_id_type": "ISIN",
      "cash_amount": "100.00",
      "currency": "EUR",
      "start_date": "2023-07-24",
      "period": "WEEK",
      "interval": 1,
      "status": "ACTIVE"
    }
  ]
}
post

Create savings plan

Create savings plan

user_idstring

required

User unique identifier.

Format
uuid
account_idstring

required

Account unique identifier.

Format
uuid
namestring

Savings plan name

typestring

required

Type of the Savings plan.

  • PORTFOLIO -
  • INSTRUMENT -
Enum
  • PORTFOLIO
  • INSTRUMENT
instrument_idOne Of

Instrument unique identifier.

Must match one of

International securities identification number defined by ISO 6166.

Pattern
^[A-Z]{2}[A-Z0-9]{9}[0-9]$
instrument_id_typestring

The type of the ID used in the request.

  • ISIN - International Securities Identification Number
  • WKN - German securities identification code
Default
"ISIN"
Enum
  • ISIN
  • WKN
cash_amountstring

required

Pattern
^[0-9]{0,63}(\.[0-9]{1,27})?$
currencystring

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR
start_datestring

required

First date of the savings plan execution in YYYY-MM-DD format.

Pattern
^[12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$
periodstring

required

Unit of time.

  • WEEK -
  • MONTH -
  • YEAR -
Enum
  • WEEK
  • MONTH
  • YEAR
intervalint

required

Number of periods between executions

Default
1
Min
1
Max
1000

Responses

Request examples

{
  "user_id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
  "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
  "name": "Instrument savings plan",
  "type": "INSTRUMENT",
  "instrument_id": "DE0007664005",
  "instrument_id_type": "ISIN",
  "cash_amount": "100.00",
  "currency": "EUR",
  "start_date": "2023-07-24",
  "period": "WEEK",
  "interval": 2
}

Response examples

Savings plan object

{
  "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
  "created_at": "2023-07-21T14:10:00.00Z",
  "updated_at": "2023-07-21T15:10:00.00Z",
  "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
  "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
  "name": "Instrument savings plan",
  "type": "INSTRUMENT",
  "instrument_id": "DE0007664005",
  "instrument_id_type": "ISIN",
  "cash_amount": "100.00",
  "currency": "EUR",
  "start_date": "2023-07-24",
  "period": "WEEK",
  "interval": 1,
  "status": "ACTIVE"
}
get

Retrieve savings plan execution

Retrieve savings plan execution

savings_plan_idstring

required

Format
uuid
savings_plan_execution_idstring

required

Format
uuid

Responses

Response examples

OK

{
  "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
  "created_at": "2023-07-21T14:10:00.00Z",
  "updated_at": "2023-07-21T15:10:00.00Z",
  "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
  "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
  "savings_plan_id": "c31083c1-1cd3-405f-95d1-f49a37f0e032",
  "order_id": "68068440-6b8e-4700-8cfc-95bf21b34b96",
  "cash_amount": "100",
  "currency": "EUR",
  "status": "FILLED",
  "type": "INSTRUMENT",
  "instrument_id": "IE00BYTRRD19",
  "instrument_id_type": "ISIN",
  "execution_date": "2023-07-24"
}
delete

Delete savings plan execution

Delete savings plan execution

savings_plan_idstring

required

Format
uuid
savings_plan_execution_idstring

required

Format
uuid

Responses

Response examples

The request has been successfully accepted and will be processed asynchronously.

Empty response

get

List savings plan executions

List savings plan executions for a saving plan specified by its ID.

start_datestring

Returns savings plan executions starting from and including this date (UTC)

Example
"2022-10-14"
end_datestring

Returns savings plan executions up to this date (UTC)

Example
"2022-10-14"
sortstring

Sort the result by execution_date.

Default
"execution_date"
Enum
  • execution_date
orderstring

Sort order of the result list if the sort parameter is specified. By default, only ASC for ascending sort.

Default
"ASC"
Enum
  • ASC
offsetint

Use the offset argument to specify where in the list of results to start when returning items for a particular query.

Format
int32
Min
0
limitint

Use the limit argument to specify the maximum number of items returned.

Format
int32
Default
100
Min
0
Max
1000

Responses

Response examples

OK

{
  "meta": {
    "offset": 0,
    "limit": 100,
    "count": 1,
    "total_count": 1,
    "sort": "id",
    "order": "ASC"
  },
  "data": [
    {
      "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
      "created_at": "2023-07-21T14:10:00.00Z",
      "updated_at": "2023-07-21T15:10:00.00Z",
      "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
      "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
      "savings_plan_id": "c31083c1-1cd3-405f-95d1-f49a37f0e032",
      "order_id": "68068440-6b8e-4700-8cfc-95bf21b34b96",
      "cash_amount": "100",
      "currency": "EUR",
      "status": "FILLED",
      "type": "INSTRUMENT",
      "instrument_id": "DE0007664005",
      "instrument_id_type": "ISIN",
      "execution_date": "2023-10-05"
    }
  ]
}
webhook

Savings plan execution events

idstring

required

Event unique identifier

Format
uuid
created_atstring

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

Format
date-time
typestring

required

Event type

Enum
  • SAVINGS_PLAN_EXECUTION.NEW
  • SAVINGS_PLAN_EXECUTION.PROCESSING
  • SAVINGS_PLAN_EXECUTION.FILLED
  • SAVINGS_PLAN_EXECUTION.SETTLED
  • SAVINGS_PLAN_EXECUTION.CANCELLED
objectobject (Savings plan)

required

idstring

required

Format
uuid
created_atstring

required

Date and time when the resource was created. RFC 3339-5, ISO8601 UTC

Format
date-time
updated_atstring

required

Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC

Format
date-time
user_idstring

required

User unique identifier.

Format
uuid
account_idstring

required

Account unique identifier.

Format
uuid
savings_plan_idstring

required

Format
uuid
order_idOne Of

required

Order unique identifier (Portfolio order or Instrument order)

Must match one of

cash_amountstring

required

Pattern
^[0-9]{0,63}(\.[0-9]{1,27})?$
currencystring

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR
statusstring

required

Status of a Savings Plan Execution.

  • NEW -
  • READY_FOR_EXECUTION -
  • SUBMITTED -
  • PROCESSING -
  • FILLED -
  • SETTLED -
  • CANCELLED -
Enum
  • NEW
  • READY_FOR_EXECUTION
  • SUBMITTED
  • PROCESSING
  • FILLED
  • SETTLED
  • CANCELLED
typestring

required

Type of the Savings plan.

  • PORTFOLIO -
  • INSTRUMENT -
Enum
  • PORTFOLIO
  • INSTRUMENT
execution_datestring

required

Date of a savings plan execution in YYYY-MM-DD format.

Pattern
^[12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$
instrument_idOne Of

Instrument unique identifier.

Must match one of

instrument_id_typestring

The type of the ID used in the request.

  • ISIN - International Securities Identification Number
  • WKN - German securities identification code
Default
"ISIN"
Enum
  • ISIN
  • WKN
webhook_idstring

required

Webhook unique identifier.

Format
uuid

Responses

Request examples

{
  "id": "54b8d84f-5bd0-4e43-bf0f-164388cb4c23",
  "created_at": "2023-07-21T10:00:00.00Z",
  "type": "SAVINGS_PLAN_EXECUTION.NEW",
  "object": {
    "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
    "created_at": "2023-07-21T14:10:00.00Z",
    "updated_at": "2023-07-21T15:10:00.00Z",
    "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
    "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
    "savings_plan_id": "c31083c1-1cd3-405f-95d1-f49a37f0e032",
    "order_id": null,
    "cash_amount": "100",
    "currency": "EUR",
    "status": "NEW",
    "type": "INSTRUMENT",
    "instrument_id": "DE0007664005",
    "instrument_id_type": "ISIN",
    "execution_date": "2023-07-23"
  },
  "webhook_id": "cd2e4183-4e62-4e0f-981b-44b594d14610"
}

Response examples

Request has been processed successfully.

Empty response

webhook

Savings plan events

idstring

required

Event unique identifier

Format
uuid
created_atstring

required

Date and time when the event was created. RFC 3339-5, ISO8601 UTC

Format
date-time
typestring

required

Event type

Enum
  • SAVINGS_PLAN.CREATED
  • SAVINGS_PLAN.UPDATED
  • SAVINGS_PLAN.CANCELLED
objectobject (Savings plan)

required

idstring

required

Format
uuid
created_atstring

required

Date and time when the resource was created. RFC 3339-5, ISO8601 UTC

Format
date-time
updated_atstring

required

Date and time when the resource was last updated. RFC 3339-5, ISO8601 UTC

Format
date-time
user_idstring

required

User unique identifier.

Format
uuid
account_idstring

required

Account unique identifier.

Format
uuid
namestring

Savings plan name

typestring

required

Type of the Savings plan.

  • PORTFOLIO -
  • INSTRUMENT -
Enum
  • PORTFOLIO
  • INSTRUMENT
instrument_idOne Of

Instrument unique identifier.

Must match one of

instrument_id_typestring

The type of the ID used in the request.

  • ISIN - International Securities Identification Number
  • WKN - German securities identification code
Default
"ISIN"
Enum
  • ISIN
  • WKN
cash_amountstring

required

Pattern
^[0-9]{0,63}(\.[0-9]{1,27})?$
start_datestring

required

First date of the savings plan execution in YYYY-MM-DD format.

Pattern
^[12]\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$
currencystring

required

Alphabetic three-letter ISO 4217 currency code.

  • EUR - Euro
Default
"EUR"
Enum
  • EUR
periodstring

required

Unit of time.

  • WEEK -
  • MONTH -
  • YEAR -
Enum
  • WEEK
  • MONTH
  • YEAR
intervalint

required

Number of periods between executions

Default
1
Min
1
Max
1000
statusstring

Status of a Savings Plan.

  • ACTIVE -
  • CANCELLED -
Enum
  • ACTIVE
  • CANCELLED
webhook_idstring

required

Webhook unique identifier.

Format
uuid

Responses

Request examples

{
  "id": "54b8d84f-5bd0-4e43-bf0f-164388cb4c23",
  "created_at": "2023-07-21T10:00:00.00Z",
  "type": "SAVINGS_PLAN.CREATED",
  "object": {
    "id": "fc34d28e-38f5-49d2-92f6-82acb79098f4",
    "created_at": "2023-07-21T14:10:00.00Z",
    "updated_at": "2023-07-21T15:10:00.00Z",
    "user_id": "4b9732bd-7496-4913-8a5f-6360479d7fed",
    "account_id": "00ef0be8-d564-43af-b3c7-11b7a2188030",
    "name": "Instrument savings plan",
    "type": "INSTRUMENT",
    "instrument_id": "DE0007664005",
    "instrument_id_type": "ISIN",
    "cash_amount": "100.00",
    "currency": "EUR",
    "start_date": "2023-07-24",
    "period": "WEEK",
    "interval": 1,
    "status": "ACTIVE"
  },
  "webhook_id": "cd2e4183-4e62-4e0f-981b-44b594d14610"
}

Response examples

Request has been processed successfully.

Empty response

Was this page helpful?