> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://allianz.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://allianz.ferndocs.com/_mcp/server.

# Code examples

Credentials and the ACCAM in these examples are placeholders. Replace them with the values Allianz Partners issues you.

## Quote requests

Send a quote request to [`POST /optimizations`](/api-reference/core/optimizations/create). The request shape depends on what the customer is booking.

#### Travel

**`Travel quote request`**

```json title="Travel quote request" maxLines={25}
{
  "credentials": {
    "password": "YOUR_PASSWORD",
    "userName": "YOUR_USERNAME"
  },
  "customers": [
    {
      "address": {
        "city": "Richmond",
        "country": "US",
        "postalCode": "23238",
        "region": "VA"
      },
      "birthDate": "1997-12-01",
      "customerId": "d6d605249c93b6c9114d10daf0193de6",
      "customerType": "PRIMARY",
      "firstName": "Jane",
      "gender": "Female",
      "lastName": "Doe",
      "memberships": [
        {
          "name": "Premium Member",
          "type": "Basic"
        }
      ],
      "sequence": 0,
      "age": 26
    },
    {
      "birthDate": "1963-11-01",
      "customerType": "OTHER",
      "firstName": "John",
      "gender": "Male",
      "lastName": "Doe",
      "sequence": 1,
      "age": 60
    }
  ],
  "gadget": {
    "browserType": "Chrome",
    "browserVersion": "95.0.4638.69",
    "deviceCategory": "Desktop",
    "deviceType": "Personal Computer",
    "operatingSystem": "Windows",
    "operatingSystemVersion": "10",
    "requestingPlatform": "None",
    "userAgent": ""
  },
  "partner": {
    "externalCode": "F999999"
  },
  "providers": [
    {
      "providerCode": "114",
      "providerName": "Sunshine Air"
    }
  ],
  "requestDetail": {
    "availablePoints": "",
    "businessUnit": "US",
    "currency": "USD",
    "costIncludes": [
      "Air"
    ],
    "itemdeliverymethod": "email",
    "language": "en",
    "offerVersionId": 2,
    "redemtpionPoints": "",
    "requestCategories": [
      "Airfare"
    ],
    "requestChannel": "Online",
    "requestedDate": "2026-10-13T20:08:03",
    "requestOrigin": "Standard",
    "requestOriginPage": "",
    "sessionId": "A692B1864E6B029D683BD66203BDD208",
    "trafficSource": "",
    "transactionId": "P0424202441"
  },
  "travel": {
    "classofService": "COACH_CLASS",
    "departureDate": "2024-12-24T03:32:00-4:00",
    "destination": {
      "city": "Punta Gorda",
      "code": "PGD",
      "country": "US",
      "region": "FL"
    },
    "includesConnection": "False",
    "isDomestic": true,
    "origin": {
      "city": "Richmond",
      "code": "RIC",
      "country": "US",
      "region": "VA"
    },
    "refundable": "False",
    "rewardMiles": "",
    "returnDate": "2024-12-29T23:32:15-4:00",
    "totalCost": 1250.84,
    "travelAgent": "Travel Agent 007",
    "travelSegments": [
      {
        "destination": {
          "code": "PGD"
        },
        "origin": {
          "code": "RIC"
        },
        "routeGroup": "12345",
        "sequence": 0,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "RIC"
            },
            "routeNumber": "111222",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "PGD"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "222333",
            "sequence": 1
          }
        ]
      },
      {
        "destination": {
          "code": "RIC"
        },
        "origin": {
          "code": "PGD"
        },
        "routeGroup": "23456",
        "sequence": 1,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "PGD"
            },
            "routeNumber": "333444",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "RIC"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "444555",
            "sequence": 1
          }
        ]
      }
    ],
    "tripIndicator": "ROUND_TRIP",
    "travelPurpose": "Leisure"
  },
  "features": [
    {
      "code": "GRUP_21301",
      "alternatives": [
        "1124521"
      ]
    }
  ]
}
```

#### Car rental

**`Car rental quote request`**

```json title="Car rental quote request" maxLines={25}
{
  "credentials": {
    "password": "YOUR_PASSWORD",
    "userName": "YOUR_USERNAME"
  },
  "customers": [
    {
      "address": {
        "city": "Richmond",
        "country": "US",
        "postalCode": "23238",
        "region": "VA"
      },
      "birthDate": "1997-12-01",
      "customerId": "d6d605249c93b6c9114d10daf0193de6",
      "customerType": "PRIMARY",
      "firstName": "Jane",
      "gender": "Female",
      "lastName": "Doe",
      "memberships": [
        {
          "name": "Premium Member",
          "type": "Basic"
        }
      ],
      "sequence": 0,
      "age": 26
    },
    {
      "birthDate": "1963-11-01",
      "customerType": "OTHER",
      "firstName": "John",
      "gender": "Male",
      "lastName": "Doe",
      "sequence": 1,
      "age": 60
    }
  ],
  "gadget": {
    "browserType": "Chrome",
    "browserVersion": "95.0.4638.69",
    "deviceCategory": "Desktop",
    "deviceType": "Personal Computer",
    "operatingSystem": "Windows",
    "operatingSystemVersion": "10",
    "requestingPlatform": "None",
    "userAgent": ""
  },
  "partner": {
    "externalCode": "F999999"
  },
  "rentalCars": [
    {
      "carClassCode": "ECAR",
      "destination": {
        "city": "Punta Gorda",
        "code": "PGD",
        "country": "US",
        "region": "FL"
      },
      "origin": {
        "city": "Punta Gorda",
        "code": "PGD",
        "country": "US",
        "region": "FL"
      },
      "endDate": "",
      "rentalCarAgency": "AVIS",
      "startDate": "",
      "totalCost": 1250.84
    }
  ],
  "providers": [
    {
      "providerCode": "114",
      "providerName": "Sunshine Air"
    }
  ],
  "requestDetail": {
    "availablePoints": "",
    "businessUnit": "CR",
    "currency": "USD",
    "costIncludes": [
      "Air",
      "Car"
    ],
    "itemdeliverymethod": "email",
    "language": "en",
    "offerVersionId": 1,
    "redemtpionPoints": "",
    "requestCategories": [
      "Rental_Car"
    ],
    "requestChannel": "Online",
    "requestedDate": "2026-10-13T20:07:49",
    "requestOrigin": "Standard",
    "requestOriginPage": "",
    "sessionId": "A692B1864E6B029D683BD66203BDD208",
    "trafficSource": "",
    "transactionId": "P04242024441"
  },
  "travel": {
    "classofService": "COACH_CLASS",
    "departureDate": "",
    "destination": {
      "city": "Punta Gorda",
      "code": "PGD",
      "country": "US",
      "region": "FL"
    },
    "includesConnection": "False",
    "isDomestic": true,
    "origin": {
      "city": "Richmond",
      "code": "RIC",
      "country": "US",
      "region": "VA"
    },
    "refundable": "False",
    "rewardMiles": "",
    "returnDate": "",
    "totalCost": 1250.84,
    "travelAgent": "Sunshine Air.com",
    "travelSegments": [
      {
        "destination": {
          "code": "PGD"
        },
        "origin": {
          "code": "RIC"
        },
        "routeGroup": "12345",
        "sequence": 0,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "RIC"
            },
            "routeNumber": "111222",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "PGD"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "222333",
            "sequence": 1
          }
        ]
      },
      {
        "destination": {
          "code": "RIC"
        },
        "origin": {
          "code": "PGD"
        },
        "routeGroup": "23456",
        "sequence": 1,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "PGD"
            },
            "routeNumber": "333444",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "RIC"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "444555",
            "sequence": 1
          }
        ]
      }
    ],
    "tripIndicator": "ROUND_TRIP",
    "travelPurpose": "Leisure"
  },
  "features": [
    {
      "code": "GRUP_21301",
      "alternatives": [
        "1124521"
      ]
    }
  ]
}
```

#### Hotel

**`Hotel quote request`**

```json title="Hotel quote request" maxLines={25}
{
  "credentials": {
    "password": "YOUR_PASSWORD",
    "userName": "YOUR_USERNAME"
  },
  "customers": [
    {
      "address": {
        "city": "Richmond",
        "country": "US",
        "postalCode": "23238",
        "region": "VA"
      },
      "birthDate": "1997-12-01",
      "customerId": "d6d605249c93b6c9114d10daf0193de6",
      "customerType": "PRIMARY",
      "firstName": "Jane",
      "gender": "Female",
      "lastName": "Doe",
      "memberships": [
        {
          "name": "Premium Member",
          "type": "Basic"
        }
      ],
      "sequence": 0,
      "age": 26
    },
    {
      "birthDate": "1963-11-01",
      "customerType": "OTHER",
      "firstName": "John",
      "gender": "Male",
      "lastName": "Doe",
      "sequence": 1,
      "age": 60
    }
  ],
  "lodgings": [
    {
      "address": {
        "address1": "500 Sunseeker Way",
        "city": "Charlotte Harbor",
        "country": "US"
      },
      "accommodationType": "Hotel",
      "brandCategory": "3",
      "cancellationPolicyType": "Flexible",
      "chain": "",
      "checkInDate": "2026-10-27",
      "checkOutDate": "2026-11-10",
      "numberOfRooms": 1,
      "refundable": false,
      "roomType": "single",
      "starRating": 6,
      "totalCost": 1250.84
    }
  ],
  "gadget": {
    "browserType": "Chrome",
    "browserVersion": "95.0.4638.69",
    "deviceCategory": "Desktop",
    "deviceType": "Personal Computer",
    "operatingSystem": "Windows",
    "operatingSystemVersion": "10",
    "requestingPlatform": "None",
    "userAgent": ""
  },
  "partner": {
    "externalCode": "F999999"
  },
  "providers": [
    {
      "providerCode": "114",
      "providerName": "Sunshine Hotels"
    }
  ],
  "requestDetail": {
    "availablePoints": "",
    "businessUnit": "US",
    "currency": "USD",
    "costIncludes": [
      "Air",
      "Hotel"
    ],
    "itemdeliverymethod": "email",
    "language": "en",
    "offerVersionId": 2,
    "redemtpionPoints": "",
    "requestCategories": [
      "Airfare"
    ],
    "requestChannel": "Online",
    "requestedDate": "2026-10-13T20:07:48",
    "requestOrigin": "Standard",
    "requestOriginPage": "",
    "sessionId": "A692B1864E6B029D683BD66203BDD208",
    "trafficSource": "",
    "transactionId": "P03424202441"
  },
  "travel": {
    "classofService": "COACH_CLASS",
    "departureDate": "2026-10-27",
    "destination": {
      "city": "Punta Gorda",
      "code": "PGD",
      "country": "US",
      "region": "FL"
    },
    "includesConnection": "False",
    "isDomestic": true,
    "origin": {
      "city": "Richmond",
      "code": "RIC",
      "country": "US",
      "region": "VA"
    },
    "refundable": "False",
    "rewardMiles": "",
    "returnDate": "2026-11-10",
    "totalCost": 1250.84,
    "travelAgent": "Sunshine Air.com",
    "travelSegments": [
      {
        "destination": {
          "code": "PGD"
        },
        "origin": {
          "code": "RIC"
        },
        "routeGroup": "12345",
        "sequence": 0,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "RIC"
            },
            "routeNumber": "111222",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "PGD"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "222333",
            "sequence": 1
          }
        ]
      },
      {
        "destination": {
          "code": "RIC"
        },
        "origin": {
          "code": "PGD"
        },
        "routeGroup": "23456",
        "sequence": 1,
        "travelLegs": [
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "ATL"
            },
            "fareClass": "DX",
            "isDomestic": true,
            "origin": {
              "code": "PGD"
            },
            "routeNumber": "333444",
            "sequence": 0
          },
          {
            "classOfService": "COACH_CLASS",
            "destination": {
              "code": "RIC"
            },
            "fareClass": "DD",
            "isDomestic": true,
            "origin": {
              "code": "ATL"
            },
            "routeNumber": "444555",
            "sequence": 1
          }
        ]
      }
    ],
    "tripIndicator": "ROUND_TRIP",
    "travelPurpose": "Leisure"
  },
  "features": [
    {
      "code": "GRUP_21301",
      "alternatives": [
        "1124521"
      ]
    }
  ]
}
```

#### Event ticket

**`Event ticket quote request`**

```json title="Event ticket quote request" maxLines={25}
{
  "credentials": {
    "password": "YOUR_PASSWORD",
    "userName": "YOUR_USERNAME"
  },
  "additionalItems": [
    {
      "cost": 50.0,
      "quantity": 1,
      "description": "Parking Pass"
    }
  ],
  "customers": [
    {
      "address": {
        "city": "Richmond",
        "country": "US",
        "postalCode": "23238",
        "region": "VA"
      },
      "birthDate": " 1980-01-15",
      "customerId": "45348962",
      "customerType": "PRIMARY",
      "firstName": "Jane",
      "gender": "Female",
      "lastName": "Doe",
      "memberships": [
        {
          "name": "Premium Member",
          "type": "Basic"
        }
      ],
      "age": 44,
      "sequence": 0
    }
  ],
  "events": [
    {
      "artistName": "Bad Bunny",
      "endDate": "2026-10-27",
      "eventName": "Bad Bunny",
      "isPremiumSeat": "True",
      "refundable": "False",
      "majorCategory": "MUSIC_EVENT",
      "minorCategory": "Hip Hop",
      "onSaleDate": "2026-10-13T20:07:38",
      "outdoorEvent": "False",
      "presaleDate": "2026-10-13T20:07:38",
      "sequence": 0,
      "startDate": "2026-10-27",
      "customerSequences": [
        0
      ],
      "ticketSalesType": "Standard",
      "ticketLimit": 1,
      "totalCost": 425.0,
      "venue": {
        "city": "Miami",
        "country": "US"
      },
      "venueName": "Kaseya Center"
    }
  ],
  "gadget": {
    "browserType": "Chrome",
    "browserVersion": "77.0.3865.120",
    "deviceCategory": "Desktop",
    "deviceType": "Personal computer",
    "operatingSystem": "Windows",
    "operatingSystemVersion": "10.1",
    "requestingPlatform": "None"
  },
  "partner": {
    "externalCode": "F999999"
  },
  "providers": [
    {
      "providerCode": "114",
      "providerName": "Ticket Provider.com"
    }
  ],
  "requestDetail": {
    "businessUnit": "US",
    "currency": "USD",
    "isRefundable": "False",
    "itemDeliveryMethod": "email",
    "language": "en",
    "offerVersionId": 1,
    "requestCategories": [
      "Event"
    ],
    "requestChannel": "Online",
    "requestedDate": "2026-10-13T20:07:38",
    "requestOrigin": "Standard",
    "requestOriginPage": "Confirmation Page",
    "sessionId": "1234567",
    "transactionId": "643e6808-e547-49e1-938e"
  }
}
```

## Purchase

Send the purchase to [`POST /Purchase`](/api-reference/purchases/purchases/create) when the customer buys the insurance.

**`Purchase request`**

```json title="Purchase request" maxLines={25}
{
  "Partner": {
    "UserID": "sampleuser",
    "Password": "YOUR_PASSWORD"
  },
  "PurchasesRequest": {
    "Accam": "YOUR_ACCAM",
    "BusinessUnit": "US",
    "TransactionID": "CDJSONTesting",
    "Purchases": {
      "Purchase": [
        {
          "PartnerBookingID": "CDJSON0011",
          "InsuranceBookingDetails": {
            "PurchaseDateTime": "2026-10-13T20:08:01",
            "Method": "ONLINE",
            "Status": "NEW",
            "Type": "ADD",
            "Currency": "USD",
            "TotalCoverageAmount": "764.02",
            "TotalPrice": "56.0",
            "TotalPremiumPrice": "56.0",
            "Purchaser": {
              "FirstName": "John",
              "MiddleInitial": "T",
              "LastName": "Doe",
              "BillingAddress": {
                "Street": "1234 Road Street",
                "Street2": "",
                "City": "St Paul",
                "Region": "MN",
                "PostalCode": "55105",
                "Country": "US"
              },
              "EmailAddress": "noreply@allianz.com",
              "PhoneNumber": "14163565173"
            },
            "FulfillmentMethod": "EMAIL",
            "PaymentMethod": "CC",
            "CreditCard": {
              "CardholderName": "John Doe",
              "ExpireMonth": "5",
              "ExpireYear": "2021",
              "CardNumber": "4012XXXXXXXX0026",
              "CardType": "VI",
              "SecurityCode": ""
            }
          },
          "GadgetDetails": {
            "BrowserType": "",
            "BrowserVersion": "",
            "DeviceCategory": "",
            "DeviceType": "",
            "OperatingSystem": "",
            "OperatingSystemVersion": "",
            "RequestingPlatform": "",
            "RequestingPlatformVersion": ""
          },
          "TravelBookingDetails": {
            "Currency": "USD",
            "TotalTripCost": "764.02",
            "TotalMiles": "1",
            "PNR": "123DD",
            "DepositDate": "2026-10-13T20:08:01",
            "CustomerID": "12345",
            "TravelAgent": "www.sampleagent.com"
          },
          "TravelDetails": {
            "DepartureDate": "2026-11-02",
            "ReturnDate": "2026-11-07",
            "RentalCarStartDate": "",
            "RentalCarEndDate": "",
            "Origin": {
              "Code": "LAX",
              "Region": "CA",
              "Country": "US"
            },
            "Destination": {
              "Code": "LHR",
              "Region": "",
              "Country": "GB"
            },
            "Providers": {
              "Provider": [
                {
                  "Code": "",
                  "Name": "www.travelagent.com"
                }
              ]
            },
            "RentalCarAgency": ""
          },
          "ProductDetails": {
            "Product": [
              {
                "Sequence": "0",
                "QuoteID": "1234567890",
                "ProductID": "001003926",
                "InsuredDetails": {
                  "Insured": [
                    {
                      "InsuredSequence": "0",
                      "InsuredType": "PRIMARY",
                      "FirstName": "John",
                      "MiddleInitial": "T",
                      "LastName": "Doe",
                      "Birthdate": "1984-10-28",
                      "Gender": "Male",
                      "IPaddress": "",
                      "InsuredAddress": {
                        "Street": "123 Summit Ave",
                        "Street2": "",
                        "City": "St Paul",
                        "Region": "MN",
                        "PostalCode": "55105",
                        "Country": "USA"
                      },
                      "PhoneNumber": "1234567890",
                      "CustomerID": "12345",
                      "NumberOfRooms": "",
                      "Memberships": {
                        "Name": "TopBuyer",
                        "Type": "Gold",
                        "Number": "123456"
                      }
                    },
                    {
                      "InsuredSequence": "1",
                      "InsuredType": "Other",
                      "FirstName": "John",
                      "LastName": "Doe",
                      "InsuredAddress": {
                        "Region": "MN",
                        "PostalCode": "55105",
                        "Country": "USA"
                      }
                    }
                  ]
                },
                "CoverageAmount": "764.02",
                "Price": "56.0",
                "PremiumPrice": "56.0",
                "ProductBookingID": "CDJSON00011"
              }
            ]
          }
        }
      ]
    }
  }
}
```

**`Purchase response`**

```json title="Purchase response" maxLines={25}
{
  "purchasesResponse": {
    "transactionID": "CDJSONTesting",
    "status": {
      "code": "SUCCESS",
      "message": "All products processed."
    },
    "purchases": {
      "purchase": [
        {
          "partnerBookingID": "CDJSON0011",
          "orderID": 33902411,
          "status": "PENDING",
          "productDetails": {
            "product": [
              {
                "sequence": 0,
                "productID": "001003926",
                "productBookingID": "CDJSON00011"
              }
            ]
          }
        }
      ]
    }
  }
}
```

## Decision

Report the outcome to [`POST /decisions`](/api-reference/core/decisions/create) when the booking completes.

**`Decision request`**

```json title="Decision request" maxLines={25}
{
  "credentials": {
    "UserID": "sampleuser",
    "Password": "YOUR_PASSWORD"
  },
  "bookingId": "PB19201320016",
  "businessUnit": "US",
  "currencyType": "USD",
  "cxid": "4153734951086967828",
  "responseId": "4153734951086967827",
  "responseType": "Purchased",
  "details": [
    {
      "responseType": "Declined",
      "supplierCode": "AWP",
      "productCode": "001004512",
      "purchasePrice": 75.0,
      "quantity": 1,
      "responseQuoteId": "4153734951086967835"
    }
  ],
  "localTs": "2024-05-16T02:48:29.442"
}
```

**`Decision response`**

```json title="Decision response" maxLines={25}
{
  "Code": "Success",
  "CreationDate": "2026-10-13T20:07:39+00:00",
  "Message": null,
  "Reason": null,
  "Source": null,
  "ErrorText": null,
  "DebugInfo": null,
  "MachineName": null,
  "ProcessId": null,
  "ResponseId": "4153734951086967827"
}
```

## OpenAPI examples

#### [OpenAPI Quote](/api-reference/core/optimizations/create)

`POST /optimizations`

#### [OpenAPI Purchase](/api-reference/purchases/purchases/create)

`POST /Purchase`

#### [OpenAPI Decisions](/api-reference/core/decisions/create)

`POST /decisions`

## Sample code

#### [Angular](https://sandbox.allianzpartnerservices.com/examples/clientcode-angular.zip)

Sample Angular client code (ZIP).

#### [React](https://sandbox.allianzpartnerservices.com/examples/clientcode-reactjs.zip)

Sample ReactJS client code (ZIP).