---
title: "Place a new financing-request for a specific accepted application (dossier)"
method: POST
path: "/mortgages/applications/{applicationId}/financing-requests"
tags: ["Mortgage Financing Request"]
---

# Place a new financing-request for a specific accepted application (dossier)

`POST /mortgages/applications/{applicationId}/financing-requests`

## Request

- Base URL: `https://mortgage.common-api.ch`
- URL: `https://mortgage.common-api.ch/mortgages/applications/{applicationId}/financing-requests`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2
    - Authorization code: `https://example.com/oauth/authorize`
    - Token URL: `https://example.com/oauth/token` scopes: `read`, `write`

Place a new financing request including all necessary information.

## Path parameters

- `applicationId` string, uuid, required: The application identifier (UUID v4) defined by FI.

## Headers

- `X-CorAPI-Client-ID` string, required
- `X-Correlation-ID` string, required
- `User-Agent` string, required

## Request body

- FinancingRequest: Based on the application, several financing requests can be sent to the FI.
  - `amount` Amount, required: amount with currency.
    - `content` string, required: amount given with fractional digits, the separator is a dot.
    - `currency` string, required: ISO 4217 code.
  - `applicationId` string, uuid, required: The application identifier (UUID v4) defined by FI.
  - `financingRequestId` string, uuid: Uuid v4 of the financing request defined by FI.
  - `increaseAmount` Amount: amount with currency.
    - `content` string, required: amount given with fractional digits, the separator is a dot.
    - `currency` string, required: ISO 4217 code.
  - `increasePurpose` string: The purpose of the increase.
  - `publicCertDate` string, date: Date format.
  - `requestOfferType` 'binding' | 'indicative': Ding dong die Hex ist tot.
  - `tranches` object[]: a mortgage amount is distributed in one or more tranches.
    - `trancheId` string, uuid: Uuid of the tranche.
    - `productId` string, uuid: Uuid of the product.
    - `productVariation` ProductVariation: Product variation details.
      - `duration` integer: The duration in years.
      - `rate` number, double: The interest rate.
      - `saronperiod` '1m' | '3m' | '6m' | '12m': The saron period.
    - `payOutDate` string, date: Date format.
    - `amount` Amount: amount with currency.
      - `content` string, required: amount given with fractional digits, the separator is a dot.
      - `currency` string, required: ISO 4217 code.
  - `usedAssets` UsedAsset[]: Assets being used for the financing request.
    - `amount` Amount, required: amount with currency.
      - `content` string, required: amount given with fractional digits, the separator is a dot.
      - `currency` string, required: ISO 4217 code.
    - `applicantId` string, uuid, required: UUID v4 of the applicant (existing applicant within the current application).
    - `assetType` 'cash' | 'gift' | 'reservation_deposit' | 'advancement_of_inheritance' | 'third_pillar' | 'third_pillar_3a' | 'third_pillar_3b' | 'pension_fund' | 'third_party_loan' | 'third_pillar_fund' | 'third_pillar_fund_3b' | 'third_pillar_fund_3a' | 'fungible_investments' | 'other' | 'vested_benefit' | 'life_insurance_3a' | 'life_insurance_3b' | 'unpledged_building_plot', required: Common set of asset types.
    - `assetProvider` AssetProvider: Asset provider for each asset, additional information must be transferred. E.g. in case the applicant owns an additional security of type insurance, insurance company name is provided
      - `name` string, required: Name of the asset provider.
    - `insuranceSum` Amount: amount with currency.
      - `content` string, required: amount given with fractional digits, the separator is a dot.
      - `currency` string, required: ISO 4217 code.
    - `usageType` 'pledged' | 'withdraw': Common set of asset usage types.

## Response `201`

created.

- CommonResourceCreatedResponse: Uuid v4 of the created resource.
  - `id` string, uuid, required: Uuid v4 of the created resource.

## Other responses

- `400`: Bad Request - The server cannot or will not process the request due to something that is perceived to be a client error as malformed request syntax.
- `401`: Unauthorized - The request has not been applied because it lacks valid authentication credentials for the target resource.
- `403`: Forbidden - The server understood the request but refuses to authorize it.
- `404`: Not Found - The origin server did not find a current representation for the target resource or is not willing to disclose that one exists.
- `405`: Method Not Allowed - The method received in the request-line is known by the origin server but not supported by the target resource.
- `500`: Internal Server Error - The server encountered an unexpected condition that prevented it from fulfilling the request.
- `501`: Not Implemented - The server does not support the functionality required to fulfill the request.
- `503`: Service Unavailable - The server is currently unable to handle the request due to a temporary overload or scheduled maintenance.

## Changes

- **2025-07-28** `735bf0a87227`: 1 info
  - api operation id `addApplicationFinancingRequest` was added
- **2023-06-06** `13f87d5f5f25`: 1 breaking, 1 warning
  - added the new path request parameter `applicationId`
  - deleted the `path` request parameter `Application ID`
- **2023-05-15** `895a72990bc3`: 10 warning
  - changed the pattern of the request property `amount/content` from `-?\d{1,14}(?:\.\d{1,3})?` to `^-?\d{1,14}(?:\.\d{1,3})?$`
  - changed the pattern of the request property `amount/currency` from `[A-Z]{3}` to `^[A-Z]{3}$`
  - changed the pattern of the request property `increaseAmount/content` from `-?\d{1,14}(?:\.\d{1,3})?` to `^-?\d{1,14}(?:\.\d{1,3})?$`
  - changed the pattern of the request property `increaseAmount/currency` from `[A-Z]{3}` to `^[A-Z]{3}$`
  - …6 more
- **2023-03-13** `3661aeb7386e`: 1 breaking, 1 warning
  - added the new path request parameter `Application ID`
  - deleted the `path` request parameter `applicationId`
- **2023-01-30** `85c41022fd68`: 2 info
  - added the new optional request property `increaseAmount`
  - added the new optional request property `increasePurpose`

[Operation history](https://skmtc.dev/swissfintechinnovations/apis/common-mortgage-api-public-2/changes/mortgages/applications/:applicationId/financing-requests/post.md)

---

[API](https://skmtc.dev/swissfintechinnovations/apis/common-mortgage-api-public-2.md) - [All operations](https://skmtc.dev/swissfintechinnovations/apis/common-mortgage-api-public-2/llms.txt) - [OpenAPI document](https://skmtc.dev/swissfintechinnovations/apis/common-mortgage-api-public-2/revisions/32dae0ff8520?raw)