canonical: https://jentic.com/apis/allianz.com/allianz # Allianz Motorbike Spain Aggregator API The Motorbike Spain Aggregator API quotes motorcycle insurance for the Spanish price-comparison market. It returns a bundle of quotes for a partner, refines an individual quote by its id, and submits a firm proposal once a quote is accepted. Authentication uses an API key, and the flow is built for aggregators integrating Allianz motor cover into their comparison journeys. ## For AI agents Request motorbike insurance quote bundles for a partner, refine a quote by id, and submit a firm proposal to Allianz for accepted quotes. ## Scope Does not handle claims, policy servicing, or non-motor insurance lines. Use for quoting and proposing Spanish motorbike insurance only. ## Capabilities - Request a bundle of motorbike insurance quotes for a partner - Refine an individual quote by its quote id - Submit a firm insurance proposal for an accepted quote ## Use cases ### AI agent insurance quoting An AI agent embedded in a comparison journey can price motorbike cover on demand. Through Jentic the agent searches by intent and the API key never enters its prompt context, so a quoting assistant can return Allianz options alongside other insurers without a hand-built integration. Example prompt: Use Jentic to search 'get a motorbike insurance quote bundle', call POST `/motorbike/es/v1/{partnerId}/quotebundles` with the rider and vehicle details, and return the priced options. ### Aggregator quote refinement After an initial bundle, a comparison site often adjusts cover options and recomputes the premium. The agent refines a specific quote by id and reads the updated price, keeping the displayed premium accurate as the customer changes their selections. Example prompt: Refine quote Q-123 for partner P-9 via POST `/motorbike/es/v1/{partnerId}/quotes/{quoteId}` and read the updated premium. ### Proposal submission When a customer accepts a quote, the aggregator submits a firm proposal to bind cover. The agent posts the proposal and stores the returned reference, moving the customer from a comparison result to an Allianz motor policy application without manual re-keying. Example prompt: Submit a firm proposal for the accepted quote via POST `/motorbike/es/v1/{partnerId}/proposals` and store the returned reference. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/motorbike/es/v1/{partnerId}/quotebundles` | Request a bundle of quotes for a partner | | POST | `/motorbike/es/v1/{partnerId}/quotes/{quoteId}` | Refine a quote by id | | POST | `/motorbike/es/v1/{partnerId}/proposals` | Submit a firm proposal | ## Key resources - **Quote Bundles** — A set of priced motorbike insurance quotes for a partner - **Quotes** — An individual quote that can be refined by id - **Proposals** — A firm proposal submitted for an accepted quote ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 63 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 86 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 56 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 42 / 100 - **View full report:** https://jentic.com/apis/allianz.com/allianz/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Motorbike Spain Aggregator API by hand means managing its x-apikey header against uat-edp.apis.allianz.com and encoding the quote, refine, and proposal calls yourself. Through Jentic you install once, import it from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The API puts the partner and quote ids in the URL path (`/motorbike/es/v1/{partnerId}/quotes/{quoteId}`), so a rule can pin your agent to one partner. You choose the operations it may call, so submitting a firm proposal is not included unless you add it. - **Credential handling:** Your Allianz API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'quote motorbike insurance' or 'submit a proposal', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **AXA Assistance** — AXA Assistance quotes and services individual insurance policies from a competing insurer - **AXA Partners** — AXA Partners quotes, binds, and services individual insurance policies - **Allianz Trade** — Allianz Trade covers trade credit risk, a different Allianz insurance line ## FAQ ### Is there a Motorbike Spain Aggregator API MCP server? You don't need an MCP server to give your agent this API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the quote, refine, and proposal operations. That keeps your agent's context free of an extra server's tool definitions. ### What authentication does the Motorbike Spain Aggregator API use? It authenticates with an API key sent in the x-apikey header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own instance and injected at call time, so it never reaches the agent's context. ### Can I get motorbike insurance quotes with this API? Yes. POST `/motorbike/es/v1/{partnerId}/quotebundles` returns a bundle of priced quotes for a partner, and POST `/motorbike/es/v1/{partnerId}/quotes/{quoteId}` refines a specific quote so the displayed premium stays current. ### How do I request a motorbike quote through Jentic? Search Jentic for 'get a motorbike insurance quote bundle', load the input schema, and execute against POST `/motorbike/es/v1/{partnerId}/quotebundles` with the rider and vehicle details. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the Motorbike Spain Aggregator API? Yes. Write a rule that allows only the quote-bundle and quote-refine operations under one partner id, so the agent can price cover for that partner and nothing else, and every call it makes is logged. Submitting a firm proposal stays out unless you add that operation.