# Create journey

Initiates a new web journey (e.g., createAccount) for the specified clientId. Provide journey configuration (account types, service type, optional allocation plan, KYC questions, transfer instructions) plus callback/redirect URLs. The response returns a journey id, a launchable url, status, and metadata you can track until completion.

Endpoint: POST /v2/partner/client/{clientId}/journey
Version: 2.0.0
Security: oAuth

## Path parameters:

  - `clientId` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Request fields (application/json):

  - `type` (string)
    Type of journey.
Mirrors the journey.journeyType

  - `journey` (object, required) — one of (discriminator: journeyType):
    - journey_sign_withdrawal:
      - `payment` (string, required)
        Fondo paymentId. (usually located on cashTransaction.ref for withdrawals)
      - `journeyType` (string)
        Enum: "signWithdrawal"
    - journey_create_legal_entity_account:
      - `journeyType` (string, required)
        Enum: "createLegalEntityAccount"
      - `accountOptions` (object, required)
        Application payload data for legal entity accounts
      - `accountOptions.serviceTypes` (array, required)
        Enum: "portfolioManagement", "investmentAdvise", "executionOnly"
      - `accountOptions.accountTypes` (array, required)
        insurance - Endowment Insurance
depot - Depot
        Enum: "insurance", "depot"
      - `accountOptions.accountCategories` (array, required)
        MiFID II investor classification.

- pro — Professional investor (MiFID II)
- retail — Retail investor, protected by consumer protection regulations (MiFID II)
        Enum: "pro", "retail"
      - `accountOptions.ownerType` (string, required)
        Enum: "legal_entity"
    - journey_sign_submission:
      - `submission` (string, required)
        Fondo application. E.g. a legal-entity signing a new account
        Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
      - `ssn` (string, required)
        Social security number of signer
        Example: "197001010003"
      - `journeyType` (string)
        Enum: "signSubmission"
    - journey_add_bank_account:
      - `account` (string, required)
        Fondo account
        Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
      - `autogiro` (object)
      - `autogiro.enforce` (any, required)
        Autogiro mandate signing requirement:
- required — End customer must sign an autogiro mandate
- optional — End customer may choose to sign an autogiro mandate
- none — No autogiro mandate option is presented
      - `autogiro.forceNewBankAccount` (boolean)
        Defaults to false.
If set to false and autogiro enforce is set to required or optional,
the end-user may select an existing account to connect to autogiro
instead of connecting a new account.

If set to true and autogiro enforce is set to required or
optional, force the end-user to connect a new bankAccount
irrespective of if old accounts exists.
      - `journeyType` (string, required)
        Enum: "addBankAccount"
    - journey_kyc_renewal:
      - `account` (string, required)
        Fondo account
      - `journeyType` (string, required)
        Enum: "kycRenewal"
    - journey_update_allocation_plan:
      - `journeyType` (string, required)
        Enum: "updateAllocationPlan"
      - `account` (string, required)
        Fondo account
      - `paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `paymentAccount.iban` (string, required)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `allocationPlan` (object)
        The new allocation plan. If provided, replaces the existing instruments and allocations.
      - `allocationPlan.instruments` (array, required)
        Instrument allocations. The sum of all allocations must be exactly 100.
        Example: [{"instrument":"SE0000810798SEK","allocation":100}]
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
    - journey_update_savings_plan:
      - `journeyType` (string, required)
        Enum: "updateSavingsPlan"
      - `account` (string, required)
        Fondo account
      - `instruments` (array)
        Instruments available for the savings plan.
If omitted, the end user may choose from all instruments in the client universe.
      - `instruments.instrument` (string, required)
        Instrument ID
    - create_account:
      - `journeyType` (string, required)
        Enum: "createAccount"
      - `welcomeScreen` (string)
        Optional custom welcome screen.
Currently only available when transfer is set.

- transfer — only allowed in combination with populated transfer field
        Enum: "transfer"
      - `email` (string,null)
        end user email address
        Example: "enduser@endUserDomain.com"
      - `accountName` (string)
        If not provided, the end-user will be asked to select accountName. If provided, the accountName will not be visible to the customer in this journey.
      - `accountTypes` (array, required)
        Allowed account types
        Enum: "isk", "depot", "insurance"
      - `accountServiceType` (string, required)
        Account service type
        Enum: same as `accountOptions.serviceTypes` in "journey_create_legal_entity_account" (3 values)
      - `accountCategories` (array)
        MiFID II investor classification. If the client permissions allows both pro and retail customers, this must be set.
It must never exceed the permissions on the client.

- pro — Professional investor (MiFID II)
- retail — Retail investor, protected by consumer protection regulations (MiFID II)
        Enum: same as `accountOptions.accountCategories` in "journey_create_legal_entity_account" (2 values)
      - `allocationPlan` (object,null)
        Setup an allocation plan for the account. Deposits will allocate based on this plan.
If null the view will not be shown
      - `allocationPlan.depositType` (any)
      - `allocationPlan.periodicity` (any)
      - `allocationPlan.paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `allocationPlan.paymentAccount.iban` (string)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `allocationPlan.instruments` (array, required)
        Instrument allocations. The sum of all allocations must be exactly 100.
        Example: [{"instrument":"SE0000810798SEK","allocation":100}]
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
      - `savingsPlan` (object,null)
        Enable savings plan setup during account creation.
User will configure instruments and amounts in the UI.
If null the view will not be shown.
      - `savingsPlan.periodicity` (string, required)
        Enum: "monthly"
      - `savingsPlan.instruments` (array)
        Instruments available for the savings plan.
If omitted, the end user may choose from all instruments in the client universe.
      - `savingsPlan.instruments.instrument` (string, required)
        Instrument ID
      - `kycs` (array,null)
        Valid Know Your Customer answers used to prefill the options in the journey.
      - `kycs.qid` (string, required)
        Fondo ID of the question
        Example: "money_origin"
      - `kycs.answer` (any, required)
        Answer
        Example: "lön/pension"
      - `transfer` (object,null)
        Transfer configuration from 3rd party institution into newly created Fondo Account.
If defined, the transfer screen is shown.
If null the transfer view will not be shown.
      - `transfer.enforce` (string, required)
        Controls whether the end user can skip the transfer step.
required means the end user must complete the transfer step.
optional means the end user may skip the transfer step.
        Enum: "required", "optional"
      - `transfer.transfers` (array, required)
        List of custodians and their accounts to transfer from.
The custodian is always readonly. Account numbers, when provided, are readonly.
      - `transfer.transfers.custodian` (string, required)
        ID matching a custodian.
      - `transfer.transfers.accounts` (array, required)
        Accounts at this custodian. Each account is either known (accountNumber set)
or unknown (accountNumber null, end user enters it).
      - `transfer.transfers.accounts.accountNumber` (string,null, required)
        Account number at the custodian. Readonly when provided.
If null, the end user enters the account number.
At most one null account number is allowed per custodian across all transfer entries.
        Example: "1223456789"
      - `transfer.transfers.accounts.sourceAccountType` (array, required)
        Allowed source account types at the custodian.
A single entry locks the type; multiple entries let the end user pick.
Each entry must be one of the journey's accountTypes.
Locked to one entry when accountNumber is provided.
        Enum: same as `accountTypes` in "create_account" (3 values)
      - `transfer.transfers.accounts.closeAccountAndSavingsplans` (boolean,null, required)
        Should the custodian close the account and corresponding savingsplans
after the transfer is complete?
If "null", the user must decide.
      - `transfer.transfers.accounts.required` (boolean, required)
        If true, the end user must complete this transfer.
If false, the end user may deselect this transfer.
      - `transfer.transfers.accounts.untransferableUnitsOutput` (array, required)
        If units are selected as output of unit transfer - what to transfer as if the transfer fails.
I.e. the instrument does not exist in universe or trading is stopped.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
ignore — leave them.
        Enum: "cash", "ignore"
      - `transfer.transfers.accounts.defaultUnitsOutput` (array, required)
        What to do with instruments not listed in instruments.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
units — transfer as units.
ignore — leave them.
        Enum: "cash", "units", "ignore"
      - `transfer.transfers.accounts.balanceOutput` (array, required)
        What to do with the account's cash balance.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — transfer the cash balance.
ignore — leave it.
        Enum: same as `transfer.transfers.accounts.untransferableUnitsOutput` in "create_account" (2 values)
      - `transfer.transfers.accounts.allowInstrumentSelection` (boolean, required)
        Should the end user be able to add specific instruments to transfer?
      - `transfer.transfers.accounts.instruments` (array)
        Specific instruments to transfer from this account.
If omitted, all instruments are handled by defaultUnitsOutput.
      - `transfer.transfers.accounts.instruments.id` (string, required)
        Instrument ID (ISIN + currency).
        Example: "SE0000810798SEK"
      - `transfer.transfers.accounts.instruments.unitType` (array, required)
        If a single entry, the behavior is locked.
If multiple entries, the end user picks.
full — all units of this instrument.
partial — a specific number of units.
        Enum: "full", "partial"
      - `transfer.transfers.accounts.instruments.outputType` (array, required)
        If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
units — transfer as units.
        Enum: "cash", "units"
      - `transfer.transfers.accounts.instruments.units` (number,null)
        Number of units to transfer.
Only applicable when unitType includes partial.
If omitted, the end user enters the amount.

  - `callbackUrl` (string, required)
    URL that receives a POST request when the journey status changes to canceled, error, or complete.
The payload includes the journey id, status, and scope.
Must use https in production.
    Example: "https://api.habibisfonder.se/v1/fondo/callback"

  - `redirectUrl` (string,null)
    Passed to BankID as the redirect target after mobile signing completes.
Set this to a deep link (e.g. customerApp:///) so BankID returns the user to your app instead of the webview.
Not needed for web-only integrations.
    Example: "customerApp:///"

  - `completionRedirectUrl` (string,null)
    URL the browser is redirected to once the journey completes successfully.
Can be an http(s) URL or a custom-scheme deep link (e.g. myapp://done) for native-app handoff.
    Example: "https://partner.example/onboarding-done"

  - `scope` (string,null, required)
    BASE64 encoded partner specific data attached to the journey, such as encrypted data containing session information. It will be passed back to callback.

## Response 200 fields (application/json):

  - `type` (string)
    Type of journey.
Mirrors the journey.journeyType

  - `status` (any)
    - new — Journey created but not yet opened by the end customer
- pending — End customer has opened the journey and is in progress
- canceled — End customer aborted the journey
- error — An error occurred during the journey
- complete — Journey completed successfully
- expired — Journey URL expired before completion

  - `id` (string)
    The ID of web journey.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `clientId` (string)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `url` (string)
    journey url
    Example: "https://webbo.fondo.se/dT7KlfoMrjOspMBvyAq2bvD8cSSAVZg50bAh8G8U6z4nNPRHAy"

  - `expiryDate` (string)
    Date when journey token is considered stale
    Example: "2018-12-13T23:59:00.001Z"

  - `journey` (object, required) — one of:
    - signWithdrawal:
      - `payment` (string, required)
        Fondo paymentId. (usually located on cashTransaction.ref for withdrawals)
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_sign_withdrawal" (1 values)
    - createLegalEntityAccount:
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_create_legal_entity_account" (1 values)
      - `accountOptions` (object, required)
        Application payload data for legal entity accounts
      - `accountOptions.serviceTypes` (array, required)
        Enum: same as `accountOptions.serviceTypes` in "journey_create_legal_entity_account" (3 values)
      - `accountOptions.accountTypes` (array, required)
        insurance - Endowment Insurance
depot - Depot
        Enum: same as `accountOptions.accountTypes` in "journey_create_legal_entity_account" (2 values)
      - `accountOptions.accountCategories` (array, required)
        MiFID II investor classification.

- pro — Professional investor (MiFID II)
- retail — Retail investor, protected by consumer protection regulations (MiFID II)
        Enum: same as `accountOptions.accountCategories` in "journey_create_legal_entity_account" (2 values)
      - `accountOptions.ownerType` (string, required)
        Enum: same as `accountOptions.ownerType` in "journey_create_legal_entity_account" (1 values)
    - signSubmission:
      - `submission` (string, required)
        Fondo application. E.g. a legal-entity signing a new account
        Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
      - `ssn` (string, required)
        Social security number of signer
        Example: "197001010003"
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_sign_submission" (1 values)
    - addBankAccount:
      - `account` (string, required)
        Fondo account
        Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"
      - `autogiro` (object)
      - `autogiro.enforce` (any, required)
        Autogiro mandate signing requirement:
- required — End customer must sign an autogiro mandate
- optional — End customer may choose to sign an autogiro mandate
- none — No autogiro mandate option is presented
      - `autogiro.forceNewBankAccount` (boolean)
        Defaults to false.
If set to false and autogiro enforce is set to required or optional,
the end-user may select an existing account to connect to autogiro
instead of connecting a new account.

If set to true and autogiro enforce is set to required or
optional, force the end-user to connect a new bankAccount
irrespective of if old accounts exists.
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_add_bank_account" (1 values)
    - kycRenewal:
      - `account` (string, required)
        Fondo account
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_kyc_renewal" (1 values)
    - updateAllocationPlan:
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_update_allocation_plan" (1 values)
      - `account` (string, required)
        Fondo account
      - `paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `paymentAccount.iban` (string, required)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `allocationPlan` (object)
        The new allocation plan. If provided, replaces the existing instruments and allocations.
      - `allocationPlan.instruments` (array, required)
        Instrument allocations. The sum of all allocations must be exactly 100.
        Example: [{"instrument":"SE0000810798SEK","allocation":100}]
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
    - updateSavingsPlan:
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "journey_update_savings_plan" (1 values)
      - `account` (string, required)
        Fondo account
      - `instruments` (array)
        Instruments available for the savings plan.
If omitted, the end user may choose from all instruments in the client universe.
      - `instruments.instrument` (string, required)
        Instrument ID
    - createAccount:
      - `journeyType` (string, required)
        Enum: same as `journeyType` in "create_account" (1 values)
      - `welcomeScreen` (string)
        Optional custom welcome screen.
Currently only available when transfer is set.

- transfer — only allowed in combination with populated transfer field
        Enum: same as `welcomeScreen` in "create_account" (1 values)
      - `email` (string,null)
        end user email address
        Example: "enduser@endUserDomain.com"
      - `accountName` (string)
        If not provided, the end-user will be asked to select accountName. If provided, the accountName will not be visible to the customer in this journey.
      - `accountTypes` (array, required)
        Allowed account types
        Enum: same as `accountTypes` in "create_account" (3 values)
      - `accountServiceType` (string, required)
        Account service type
        Enum: same as `accountOptions.serviceTypes` in "journey_create_legal_entity_account" (3 values)
      - `accountCategories` (array)
        MiFID II investor classification. If the client permissions allows both pro and retail customers, this must be set.
It must never exceed the permissions on the client.

- pro — Professional investor (MiFID II)
- retail — Retail investor, protected by consumer protection regulations (MiFID II)
        Enum: same as `accountOptions.accountCategories` in "journey_create_legal_entity_account" (2 values)
      - `allocationPlan` (object,null)
        Setup an allocation plan for the account. Deposits will allocate based on this plan.
If null the view will not be shown
      - `allocationPlan.depositType` (any)
      - `allocationPlan.periodicity` (any)
      - `allocationPlan.paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `allocationPlan.paymentAccount.iban` (string)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `allocationPlan.instruments` (array, required)
        Instrument allocations. The sum of all allocations must be exactly 100.
        Example: [{"instrument":"SE0000810798SEK","allocation":100}]
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
      - `savingsPlan` (object,null)
        Enable savings plan setup during account creation.
User will configure instruments and amounts in the UI.
If null the view will not be shown.
      - `savingsPlan.periodicity` (string, required)
        Enum: same as `savingsPlan.periodicity` in "create_account" (1 values)
      - `savingsPlan.instruments` (array)
        Instruments available for the savings plan.
If omitted, the end user may choose from all instruments in the client universe.
      - `savingsPlan.instruments.instrument` (string, required)
        Instrument ID
      - `kycs` (array,null)
        Valid Know Your Customer answers used to prefill the options in the journey.
      - `kycs.qid` (string, required)
        Fondo ID of the question
        Example: "money_origin"
      - `kycs.answer` (any, required)
        Answer
        Example: "lön/pension"
      - `transfer` (object,null)
        Transfer configuration from 3rd party institution into newly created Fondo Account.
If defined, the transfer screen is shown.
If null the transfer view will not be shown.
      - `transfer.enforce` (string, required)
        Controls whether the end user can skip the transfer step.
required means the end user must complete the transfer step.
optional means the end user may skip the transfer step.
        Enum: same as `transfer.enforce` in "create_account" (2 values)
      - `transfer.transfers` (array, required)
        List of custodians and their accounts to transfer from.
The custodian is always readonly. Account numbers, when provided, are readonly.
      - `transfer.transfers.custodian` (string, required)
        ID matching a custodian.
      - `transfer.transfers.accounts` (array, required)
        Accounts at this custodian. Each account is either known (accountNumber set)
or unknown (accountNumber null, end user enters it).
      - `transfer.transfers.accounts.accountNumber` (string,null, required)
        Account number at the custodian. Readonly when provided.
If null, the end user enters the account number.
At most one null account number is allowed per custodian across all transfer entries.
        Example: "1223456789"
      - `transfer.transfers.accounts.sourceAccountType` (array, required)
        Allowed source account types at the custodian.
A single entry locks the type; multiple entries let the end user pick.
Each entry must be one of the journey's accountTypes.
Locked to one entry when accountNumber is provided.
        Enum: same as `accountTypes` in "create_account" (3 values)
      - `transfer.transfers.accounts.closeAccountAndSavingsplans` (boolean,null, required)
        Should the custodian close the account and corresponding savingsplans
after the transfer is complete?
If "null", the user must decide.
      - `transfer.transfers.accounts.required` (boolean, required)
        If true, the end user must complete this transfer.
If false, the end user may deselect this transfer.
      - `transfer.transfers.accounts.untransferableUnitsOutput` (array, required)
        If units are selected as output of unit transfer - what to transfer as if the transfer fails.
I.e. the instrument does not exist in universe or trading is stopped.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
ignore — leave them.
        Enum: same as `transfer.transfers.accounts.untransferableUnitsOutput` in "create_account" (2 values)
      - `transfer.transfers.accounts.defaultUnitsOutput` (array, required)
        What to do with instruments not listed in instruments.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
units — transfer as units.
ignore — leave them.
        Enum: same as `transfer.transfers.accounts.defaultUnitsOutput` in "create_account" (3 values)
      - `transfer.transfers.accounts.balanceOutput` (array, required)
        What to do with the account's cash balance.
If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — transfer the cash balance.
ignore — leave it.
        Enum: same as `transfer.transfers.accounts.untransferableUnitsOutput` in "create_account" (2 values)
      - `transfer.transfers.accounts.allowInstrumentSelection` (boolean, required)
        Should the end user be able to add specific instruments to transfer?
      - `transfer.transfers.accounts.instruments` (array)
        Specific instruments to transfer from this account.
If omitted, all instruments are handled by defaultUnitsOutput.
      - `transfer.transfers.accounts.instruments.id` (string, required)
        Instrument ID (ISIN + currency).
        Example: "SE0000810798SEK"
      - `transfer.transfers.accounts.instruments.unitType` (array, required)
        If a single entry, the behavior is locked.
If multiple entries, the end user picks.
full — all units of this instrument.
partial — a specific number of units.
        Enum: same as `transfer.transfers.accounts.instruments.unitType` in "create_account" (2 values)
      - `transfer.transfers.accounts.instruments.outputType` (array, required)
        If a single entry, the behavior is locked.
If multiple entries, the end user picks.
cash — sell and transfer as cash.
units — transfer as units.
        Enum: same as `transfer.transfers.accounts.instruments.outputType` in "create_account" (2 values)
      - `transfer.transfers.accounts.instruments.units` (number,null)
        Number of units to transfer.
Only applicable when unitType includes partial.
If omitted, the end user enters the amount.

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)

  - `createdDate` (string)
    Date when acocunt was created
    Example: "2018-12-13T23:59:00.001Z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `deleted` (boolean)
    True if the journey is deleted

  - `deletedDate` (string,null)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `submission` (any)
    optional submission id.
May be created in legal entity journeys.
May be fetched on separate GET /submission/:id route

  - `callbackUrl` (string, required)
    URL that receives a POST request when the journey status changes to canceled, error, or complete.
The payload includes the journey id, status, and scope.
Must use https in production.
    Example: "https://api.habibisfonder.se/v1/fondo/callback"

  - `redirectUrl` (string,null)
    Passed to BankID as the redirect target after mobile signing completes.
Set this to a deep link (e.g. customerApp:///) so BankID returns the user to your app instead of the webview.
Not needed for web-only integrations.
    Example: "customerApp:///"

  - `completionRedirectUrl` (string,null)
    URL the browser is redirected to once the journey completes successfully.
Can be an http(s) URL or a custom-scheme deep link (e.g. myapp://done) for native-app handoff.
    Example: "https://partner.example/onboarding-done"

  - `errorCode` (string,null)
    Any errors occurring during journey

  - `context` (string,null)
    Where end-user exited the journey. On error on cancel, if applicable.
    Example: "createaccountsign"

  - `scope` (string,null, required)
    BASE64 encoded partner specific data attached to the journey, such as encrypted data containing session information. It will be passed back to callback.

  - `result` (object,null) — one of:
    Result of journey
    - createAccount result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "create_account" (1 values)
      - `account` (object)
        account created in journey
      - `account.id` (string)
        id of account
      - `account.status` (string)
        - pending — Account created, waiting for approval
- active — Account is open and operational
- rejected — Account application was rejected
- confirm — Account is awaiting confirmation from the end customer
- closing — Account is being closed; new orders, payments and withdrawals are not accepted
        Enum: "pending", "active", "rejected", "confirm", "closing"
      - `account.accountType` (string)
        - isk — ISK, investeringssparkonto
- depot — Depot, fonddepå
- insurance — Endowment insurance, kapitalförsäkring. Requires the user to sign separately with the insurance provider.
        Enum: same as `accountTypes` in "create_account" (3 values)
      - `account.serviceType` (string)
        - portfolioManagement — Portfolio management
- investmentAdvise — Investment advice
- executionOnly — Execution only
        Enum: same as `accountOptions.serviceTypes` in "journey_create_legal_entity_account" (3 values)
      - `bankAccounts` (array)
        Payment accounts registered with allocation plan or savings plan
      - `bankAccounts.id` (string)
        id of payment account
      - `bankAccounts.status` (string)
        Mandate status of the payment account
- pending — Pending verification
- rejected — Rejected
- active — Active, ready for withdrawals
        Enum: "pending", "rejected", "active"
      - `bankAccounts.iban` (string)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `transfers` (array)
        If transfers from other custodian was created, the results are provided here. One item per account.
      - `transfers.custodian` (string)
        ID matching an institution.
      - `transfers.account` (string)
        Account number at institution
        Example: "1223456789"
      - `allocationPlan` (object)
        If an allocationPlan was created. The results are provided here
      - `allocationPlan.id` (string)
        id of allocation plan
      - `allocationPlan.paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `allocationPlan.paymentAccount.id` (string)
        id of payment account
      - `allocationPlan.paymentAccount.iban` (string)
        IBAN (ISO 13616, International Bank Account Number)
        Example: "SE7280000810340009783242"
      - `allocationPlan.instruments` (array)
        Instrument allocations. The sum of all allocations must be exactly 100.
        Example: [{"instrument":"SE0000810798SEK","allocation":100}]
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
      - `savingsplan` (object)
        If a savings plan was created. The results are provided here
      - `savingsplan.id` (string)
        id of savings plan
      - `savingsplan.paymentAccountId` (string)
        id of payment account used for autogiro
      - `savingsplan.periodicity` (string)
        Enum: same as `savingsPlan.periodicity` in "create_account" (1 values)
      - `savingsplan.day` (number)
        Day of the month to allocate
      - `savingsplan.instruments` (array)
        Instrument allocations with fixed amounts
      - `savingsplan.instruments.instrument` (string)
        Instrument ID
      - `savingsplan.instruments.amount` (number)
        Amount in SEK
    - updateAllocationPlan result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_update_allocation_plan" (1 values)
      - `allocationPlan` (object)
      - `allocationPlan.account` (string)
        Fondo account id
      - `allocationPlan.instruments` (array)
        Updated instrument allocations. The sum of all allocations must be exactly 100.
      - `allocationPlan.instruments.instrument` (string, required)
        Instrument ID
        Example: "SE0000810798SEK"
      - `allocationPlan.instruments.allocation` (number, required)
        Allocation in percent for this instrument
        Example: 100
      - `allocationPlan.paymentAccount` (object)
        The details of the bank account to charge from (autogiro)
      - `allocationPlan.paymentAccount.id` (string)
        id of payment account
    - updateSavingsPlan result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_update_savings_plan" (1 values)
      - `savingsplan` (object)
      - `savingsplan.id` (string)
        id of savings plan
      - `savingsplan.paymentAccountId` (string)
        id of payment account used for autogiro
      - `savingsplan.startDate` (string)
        Date when the savings plan starts
      - `savingsplan.instruments` (array)
        Instrument allocations with fixed amounts
      - `savingsplan.instruments.instrument` (string)
        Instrument ID
      - `savingsplan.instruments.amount` (number)
        Amount in SEK
    - signSubmission result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_sign_submission" (1 values)
      - `submission` (object)
      - `submission.submission` (string)
        id of the signed submission
    - createLegalEntityAccount result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_create_legal_entity_account" (1 values)
      - `submission` (object)
      - `submission.submission` (string)
        id of the signed submission
    - kycRenewal result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_kyc_renewal" (1 values)
    - addBankAccount result:
      - `journeyType` (string)
        Enum: same as `journeyType` in "journey_add_bank_account" (1 values)

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error