canonical: https://jentic.com/apis/cruzsuiza.com/cruzsuiza

# Cruz Suiza Seguros Producers API

The Cruz Suiza Seguros Producers API gives insurance producers programmatic access to the Latin American insurer's quoting tools. After signing in with an Amazon Cognito JWT, a producer can list available occupations, read their authenticated producer context, and request a personal-accident insurance quote. A public health-check endpoint reports service status.

## For AI agents

Lets an AI agent list occupations, read producer context, and request personal-accident insurance quotes from Cruz Suiza, authenticated with a Cognito JWT bearer token.

## Scope

Does not issue policies, process claims, or take premium payments: use it to list occupations, read producer context, and request quotes only.

## Capabilities

- Check service health without authentication
- List available occupation classifications
- Read the authenticated producer's context
- Request a personal-accident insurance quote

## Use cases

### Producer quoting portal

Insurance brokers quote personal-accident cover for clients. The Cruz Suiza API lists the supported occupations and accepts a quote request, so a producer portal can price a policy without manual lookups.

Example prompt: List the available occupations, then request a personal-accident quote for a selected occupation

### Occupation reference sync

Quoting tools need the current list of occupation classifications that drive pricing. The API returns the available occupations so a tool can keep its dropdowns and rating logic current.

Example prompt: Fetch the available occupation classifications and refresh the quoting tool's reference list

### Agent-driven quote assistant

A producer-facing agent can gather a quote on request. Through Jentic, an agent reads the producer context and occupations and then submits a quote request on the producer's behalf.

Example prompt: Read the producer context, pick an occupation, and request a personal-accident quote

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/health` | Service health check |
| GET | `/ocupaciones` | List available occupations |
| GET | `/contexto` | Get the authenticated producer context |
| POST | `/cotizaciones` | Request a personal-accident quote |

## Key resources

- **Health** — Public service health check
- **Occupations** — List available occupation classifications
- **Producer context** — Read the authenticated producer's context
- **Quotes** — Request a personal-accident insurance 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:** 69 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 82 / 100
  - AI-Readiness & Agent Experience: 51 / 100
  - Agent Usability: 94 / 100
  - Security: 75 / 100
  - AI Discoverability: 44 / 100
- **View full report:** https://jentic.com/apis/cruzsuiza.com/cruzsuiza/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 <openapi-url>
```

## Why Jentic

- **Setup:** Cruz Suiza issues an Amazon Cognito JWT from a producer client id and secret before quoting. With Jentic One you install once, import the operations from the API Directory, and the token exchange is handled for you.
- **Permission scoping:** The protected operations act on the authenticated producer rather than arbitrary record ids, so scoping is at the operation level: an agent can be limited to reading occupations and requesting quotes.
- **Credential handling:** Your Cruz Suiza client id and secret are stored encrypted by your own Jentic One instance and used only to mint tokens at execution time, so they never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents find the quoting operation through Jentic's intent search, matching a request like getting a personal-accident insurance quote to the matching Cruz Suiza endpoint.

## Related APIs

- **Claim.MD** — Insurance claims clearinghouse
- **Stripe** — Payment processing for collecting premiums
- **Checkout.com** — Card payment processing across markets

## FAQ

### How does the Cruz Suiza Producers API authenticate?

Producers exchange a client id and secret for an Amazon Cognito JWT, which is sent as a bearer token on each protected request. The health check needs no token. Jentic One manages the token and injects it at execution time.

### Can I limit what my agent can do with the Cruz Suiza API?

Yes. You import only the operations an agent needs, so a quoting agent can request quotes and read occupations while anything outside that stays unavailable.

### What is a personal-accident quote?

It is a price for personal-accident insurance cover, calculated from inputs such as the client's occupation. The quote operation returns that pricing for a producer to present.

### What language does the API use?

The spec and responses use Spanish for a Latin American audience, and an agent can still call each operation programmatically regardless of language.

### Does the health check need authentication?

No. The health endpoint is public and reports service status without a token; the occupation, context, and quote operations require the Cognito bearer token.