---
title: "Courtage vorab berechnen"
url: "https://maklerportal.apim.eu/apis/provisionsabrechnung/versions/66d24f0e-eec7-434f-880d-19abbf6211e5/operations/courtageBerechnen"
---

> Full API specification: https://maklerportal.apim.eu/apis/provisionsabrechnung/versions/66d24f0e-eec7-434f-880d-19abbf6211e5.md

# Courtage vorab berechnen

`POST` `/courtage/rechner`

Operation ID: `courtageBerechnen`

Rechnet eine Courtage durch, ohne eine Abrechnung anzulegen – nützlich für Angebotsgespräche und für die Anzeige im Exposé.

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Berechnung

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Provisionsabrechnung
  version: 1.0.0
servers:
  - url: https://api.maklerportal.example/v1
    description: Produktion
  - url: https://sandbox.api.maklerportal.example/v1
    description: Sandbox
paths:
  /courtage/rechner:
    post:
      tags:
        - Courtage
      summary: Courtage vorab berechnen
      description: >
        Rechnet eine Courtage durch, ohne eine Abrechnung anzulegen – nützlich
        für

        Angebotsgespräche und für die Anzeige im Exposé.
      operationId: courtageBerechnen
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - bemessungsgrundlage_eur
                - kaeufer_prozent
              properties:
                bemessungsgrundlage_eur:
                  type: integer
                  example: 645000
                kaeufer_prozent:
                  type: number
                  format: float
                  example: 3.57
                verkaeufer_prozent:
                  type: number
                  format: float
                  example: 3.57
                umsatzsteuer_prozent:
                  type: number
                  format: float
                  default: 19
      responses:
        "200":
          description: Berechnung
          content:
            application/json:
              schema:
                type: object
                properties:
                  positionen:
                    type: array
                    items:
                      $ref: "#/components/schemas/Position"
                  summe_brutto_eur:
                    type: number
                    format: float
                    example: 46061
security:
  - apiKey: []
components:
  schemas:
    Position:
      type: object
      properties:
        partei:
          type: string
          enum:
            - kaeufer
            - verkaeufer
            - mieter
            - vermieter
        satz_prozent:
          type: number
          format: float
          example: 3.57
        netto_eur:
          type: number
          format: float
          example: 19353.36
        umsatzsteuer_eur:
          type: number
          format: float
          example: 3677.14
        brutto_eur:
          type: number
          format: float
          example: 23030.5
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >
        Jeder Aufruf trägt einen API-Schlüssel im Header `apikey`. Den Schlüssel

        erzeugen Sie im Maklerportal unter "Meine Anwendungen"; er wird genau
        einmal

        angezeigt.


        An jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,

        antwortet die API mit `403` und `code: "scope_fehlt"`; der fehlende
        Scope

        steht in `details[].feld`.
```