---
title: "Place a new order"
method: POST
path: "/mortgages/orders"
tags: ["Mortgage Order"]
---

# Place a new order

`POST /mortgages/orders`

Place a new order referencing a specific offerId and either an existing mortgage id (prolongation) or an application id (new
mortgage) including all relevant information.

## Headers

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

## Request body

- Order — All information needed to choose a specific offer and place a binding order.
  - `offerId` string, uuid, required — Uuid v4 of the specific order.
  - `applicationId` string, uuid — The application identifier (UUID v4) defined by FI.
  - `mortgageId` string, uuid — Uuid v4 of the mortgage.
  - `orderId` string, uuid — Uuid v4 of the order defined by FI.
  - `remark` string — Remark/comment which can be added by TPP.

## 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.

---

[API](https://skmtc.net/swissfintechinnovations/apis/common-mortgage-api-public-2.md) · [All operations](https://skmtc.net/swissfintechinnovations/apis/common-mortgage-api-public-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swissfintechinnovations/common-mortgage-api-public-2/revisions/32dae0ff8520/schema)