# Turn the Allianz Maklerportal into an API

> Search the Vertragsübersicht, read the Elektronisches Postfach and pull Einzelbuchungen from Buchungen Leben with one API call each. A workflow can check the Postfach each morning and email you the unread Vermittlerpost.

Page: https://fous.com/automate/allianz-maklerportal
Updated: 2026-11-12

Works with your own Allianz Maklerportal account. Fous is an independent product.

## What you can build on the Maklerportal

### Search contracts in the Vertragsübersicht

Runs a search in the Vertragsübersicht (contract overview) by name, Vertragsnummer, Kfz-Kennzeichen or Vertragsstatus and reads the matching contracts.

- Takes: Name or Vertragsnummer or Kfz-Kennzeichen, Vertragsstatus (optional), Ablauf before (optional)
- Returns: Customer name, Vertragsnummer, Bereich, Vertragsart, Vertragsstatus, Kfz-Kennzeichen, Beginn, Ablauf

### List new documents in the Postfach

Reads the Elektronisches Postfach (electronic mailbox) for one Vermittlernummer: the Vermittlerpost, Courtage documents and Vergütungsdatenblätter that arrived.

- Takes: Vermittlernummer, unread only (optional), Sparte (optional)
- Returns: Date, Sparte, Versicherungsnehmer, Versicherungsnummer, Betreff, read or unread

### Get Einzelbuchungen from Buchungen Leben

Reads the Einzelbuchungen (individual bookings) in Buchungen Leben for one Vergütungsabrechnung or a period, with the Provisionsgrund of each booking.

- Takes: Vermittlernummer, Vergütungsabrechnung or date range, Provisionsgrund (optional)
- Returns: Vertragsnummer, versicherte Person, Provisionsgrund, Provisionsbasissumme, Provisionsbetrag

### Send a contract message to the Innendienst

Opens a contract from the Vertragsübersicht, chooses a Thema and sends your message to the Innendienst (back office) for that contract.

- Takes: Vertragsnummer, Thema, message text
- Returns: Vertragsnummer, Thema, sent at

## Automate the Maklerportal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Unread Vermittlerpost, every Vermittlernummer

Starts: Every weekday at 8:00

1. For each Vermittlernummer you name, list the unread documents in the Elektronisches Postfach.
2. Keep the documents that were not there on the last run.
3. Email you the list, one section per Vermittlernummer, with Versicherungsnehmer, Versicherungsnummer and Betreff.

### Leben Courtage bookings to your accounting system

Starts: Every Monday at 7:00

1. For each Vermittlernummer, get the Einzelbuchungen in Buchungen Leben for the last 7 days.
2. Stop when there are none.
3. Post Vertragsnummer, Provisionsgrund, Provisionsbasissumme and Provisionsbetrag to your accounting webhook.

### Contracts reaching their Ablauf in the next 90 days

Starts: On the 1st of every month at 7:00

1. Search the Vertragsübersicht for aktiv contracts with an Ablauf in the next 90 days.
2. Keep the contracts that were not on the last run's list.
3. Email you the contracts grouped by Bereich, with customer name, Vertragsnummer and Ablauf.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Search contracts in the Vertragsübersicht” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "makler.allianz.de/search_contracts",
    "input": {
      "name": "Northwind",
      "vertragsstatus": "aktiv"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "contracts": [
      {
        "customer_name": "Northwind Logistik GmbH",
        "vertragsnummer": "AS-0000-7731",
        "bereich": "Sach",
        "vertragsart": "Kraft Kleinflotten",
        "vertragsstatus": "aktiv",
        "kfz_kennzeichen": null,
        "beginn": "2024-01-01",
        "ablauf": "2027-01-01"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The Maklerportal’s own options

Allianz offers BiPRO web services for Sach, Leben and Kranken: Bestandsservices for portfolio data and TAA services for Tarifierung, Angebot and Antrag. They run inside a BiPRO-capable Maklerverwaltungsprogramm, need a separate request for access and an Allianz certificate, and their details are agreed individually. The portal also offers a GDV file download of your Bestand.

| Option | What it covers | What it takes |
| --- | --- | --- |
| BiPRO web services | Bestandsservices (including a daily Gesamt- and Änderungsbestand) and TAA services for Tarifierung, Angebot and Antrag, in Sach, Leben and Kranken. | A written access request, a BiPRO-capable Maklerverwaltungsprogramm and the Allianz certificate installed in it. Terms agreed individually. |
| GDV-Daten downloaden | Bestands- und Schadendaten for one or all Vermittlernummern as a zipped GDV file. No Courtage or Inkasso data. | The Bestandsdaten mit Download right, requested under Mein Konto. Files are capped at 2.1 GB. |
| The Maklerportal by hand | Vertragsübersicht, Elektronisches Postfach (PDF per document) and Buchungen Leben (Einzelbuchungen as CSV, Vergütungsabrechnungen as PDF). | A personal access for a reversierter Vermittler, with the rights for each application. |

Read on November 12, 2026: [BiPRO at Allianz (Maklerportal)](https://makler.allianz.de/leben/bipro-datenaustausch/bipro.html), [GDV-Daten downloaden](https://makler.allianz.de/bestand/bestandsservices/gdv_daten.html), [Nutzungsbedingungen Allianz Onlinedienste (AMV5006Z0)](https://makler.allianz.de/content/dam/onemarketing/dechap/common/makler/documents/zugang/AMV5006Z0_Nutzungsbedingungen_Allianz_Onlinedienste.pdf).

## Signing in to the Maklerportal

The Maklerportal signs you in with your Benutzerschlüssel and a personal password that you renew after a set time, with an Allianz certificate in your browser, or through easy Login single sign-on. A 2-Faktor-Login is managed under Mein Konto. With Fous you sign in once through the Maklerportal's own sign-in with your own access: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Contract search runs a day behind**: Contracts are imported overnight, so the Vertragsübersicht search shows them with a delay of one day. The contract details themselves show the current state.
- **Your rights decide what a method can read**: Basis-Anwender have no Bestands- or Courtagerechte. The Postfach needs Bestand rights, and Courtage documents also need Abrechnung Sach, Buchungen Leben or Buchungen Kranken.
- **Read status is shared with your colleagues**: Gelesen, ungelesen and Löschen in the Elektronisches Postfach apply to a document for every user authorized to see it. Deleted documents stay available with the status gelöscht.
- **BiPRO needs the certificate**: Benutzerschlüssel and password do not work for the BiPRO web services: they require the Allianz certificate, installed in the Maklerverwaltungsprogramm.

## More in Insurance

- [Aviva Broker](https://fous.com/automate/aviva-broker.md)
- [AXA Connect](https://fous.com/automate/axa-connect.md)
- [PPL](https://fous.com/automate/ppl.md)
- [Navigate](https://fous.com/automate/navigate.md)
- [HealthSherpa](https://fous.com/automate/healthsherpa.md)
- [Covered California Enroller Portal](https://fous.com/automate/covered-california-enroller-portal.md)
- [HealthCare.gov for agents and brokers](https://fous.com/automate/healthcare-gov-for-agents-and-brokers.md)
- [HealthEquity employer portal](https://fous.com/automate/healthequity-employer-portal.md)
- [Optum Financial employer portal](https://fous.com/automate/optum-financial-employer-portal.md)
- [WEX Benefits employer portal](https://fous.com/automate/wex-benefits-employer-portal.md)
- [NIPR](https://fous.com/automate/nipr.md)
- [Aflac Business Services](https://fous.com/automate/aflac-business-services.md)
- [National General agent portal](https://fous.com/automate/national-general-agent-portal.md)
- [Travelers for Agents](https://fous.com/automate/travelers-for-agents.md)
- [Nationwide Agent Center](https://fous.com/automate/nationwide-agent-center.md)
- [The Hartford EBC](https://fous.com/automate/the-hartford-ebc.md)
- [Citizens PolicyCenter and myAgency](https://fous.com/automate/citizens-policycenter-and-myagency.md)

Other industries: [Portal Informacyjny Sądów Powszechnych](/automate/portal-informacyjny-sadow-powszechnych), [Extensiv 3PL Warehouse Manager](/automate/extensiv-3pl-warehouse-manager), [LPL ClientWorks](/automate/lpl-clientworks), [myDCLI](/automate/mydcli), [Carrier 360 by J.B. Hunt](/automate/carrier-360-by-j-b-hunt), [Exostar](/automate/exostar).

## Frequently asked questions

### Does the Allianz Maklerportal have an API?

Yes, as BiPRO web services: Bestandsservices and TAA services for Sach, Leben and Kranken, used from a BiPRO-capable Maklerverwaltungsprogramm with the Allianz certificate. Access is requested separately and details are agreed individually. Screens such as the Elektronisches Postfach and Buchungen Leben are used in the browser.

### Can I download my whole Allianz Bestand as a file?

Yes, with GDV-Daten downloaden: Bestands- und Schadendaten for one or all Vermittlernummern as a zipped GDV file, up to 2.1 GB. It carries no Courtage or Inkasso data, and the first file is prepared at the end of a month and ready by the middle of the next.

### Where do I find my Leben Courtage bookings?

In Buchungen Leben. Each Zahlungslauf produces a Vergütungsabrechnung as PDF, and the Einzelbuchungen show Vertragsnummer, Provisionsgrund, Provisionsbasissumme and Provisionsbetrag, downloadable as CSV.

### Which documents arrive in the Elektronisches Postfach?

Contract-related Vermittlerpost for Sach, Leben and Kranken, including copies of customer letters, plus Courtage and Abrechnung documents for Sach and Leben and Vergütungsdatenblätter for Leben and Kranken. You can stop the paper copies per Vermittlernummer with the Papierverzicht form.

### Is Fous affiliated with Allianz?

No. Fous is an independent product. You use it with your own Allianz Maklerportal access, and a method reads and does only what that access can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Allianz Maklerportal (Allianz Versicherungs-AG, Allianz Lebensversicherungs-AG and Allianz Krankenversicherungs-AG). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.