v50

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2026-05-273145122.2 KB

Mortgage Financing Request

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

Place a new financing request including all necessary information.

post/mortgages/applications/{applicationId}/financing-requests

Path parameters

applicationIdstring uuid required

The application identifier (UUID v4) defined by FI.

Example:4bf92636-14a0-4511-98e2-acfde576e644

Uuid v4 of the application request.

Headers

X-CorAPI-Client-IDstring required

ID of the client forwarded to the provider.

X-Correlation-IDstring required

Unique ID (defined by the caller) which will be reflected back in the response.

User-Agentstring required

Name and version of the of the Client software.

Request body

applicationIdstring uuid required

The application identifier (UUID v4) defined by FI.

financingRequestIdstring uuid

Uuid v4 of the financing request defined by FI.

increasePurposestring

The purpose of the increase.

publicCertDatestring date

Date format.

requestOfferType'binding' | 'indicative'

Ding dong die Hex ist tot.

Example request

{
  "amount": {
    "content": "235.45",
    "currency": "CHF"
  },
  "applicationId": "4bf92636-14a0-4511-98e2-acfde576e644",
  "financingRequestId": "4bf92636-14a0-4511-98e2-acfde576e644",
  "increaseAmount": {
    "content": "235.45",
    "currency": "CHF"
  },
  "increasePurpose": "renovation of the kitchen",
  "publicCertDate": "2018-04-13",
  "requestOfferType": "binding",
  "tranches": [
    {
      "trancheId": "51b017e1-5e59-4b58-a0a0-c638c87db463",
      "productId": "4bf92636-14a0-4511-98e2-acfde576e644",
      "productVariation": {
        "duration": 5,
        "rate": 0.5,
        "saronperiod": "3m"
      },
      "payOutDate": "2018-04-13",
      "amount": {
        "content": "235.45",
        "currency": "CHF"
      }
    }
  ],
  "usedAssets": [
    {
      "amount": {
        "content": "235.45",
        "currency": "CHF"
      },
      "applicantId": "576f8de3-6b30-4882-a7af-da2132a456cf",
      "assetType": "cash",
      "assetProvider": {
        "name": "Credit Suisse"
      },
      "insuranceSum": {
        "content": "235.45",
        "currency": "CHF"
      },
      "usageType": "pledged"
    }
  ]
}

Response

created.

idstring uuid required

Uuid v4 of the created resource.

Example response

{
  "id": "4bf92636-14a0-4511-98e2-acfde576e644"
}