canonical: https://jentic.com/apis/cruzeirotickets.com.br/cruzeirotickets-com-br

# Cruzeirotickets BaladAPP Partner Integration API

BaladAPP is the partner-integration API behind Cruzeiro's ticketing and subscription platform. With a partner API token, an integration can read subscription plans, add-ons, and benefits, list subscriptions and the customers who hold them, browse event listings (announcements and matches) with their sessions and tickets, and retrieve the orders placed against each event. It gives partner systems read access to plans, events, tickets, and orders.

## For AI agents

Lets an AI agent read Cruzeiro BaladAPP subscription plans, subscriptions, customers, events, tickets, and orders with a partner token.

## Scope

Does not sell tickets, take payments, or create subscriptions: use it to read BaladAPP plans, events, tickets, and orders only.

## Capabilities

- List subscription plans, add-ons, and benefits
- Read subscriptions and the customers who hold them
- Look up a customer's tickets, orders, and subscriptions
- Browse event announcements and matches on sale
- List sessions, tickets, and orders for an event

## Use cases

### Partner listing sync

Partner storefronts mirror the available plans and events. BaladAPP lists plans, add-ons, benefits, and the events on sale, so a partner system can keep its own listings aligned with what Cruzeiro is currently offering.

Example prompt: List the available subscription plans and the events on sale to refresh a partner's listings

### Customer entitlement lookup

Support and loyalty tools need to see what a customer holds. The API returns a customer's subscriptions, tickets, and orders, so an assistant can confirm entitlements before answering a question.

Example prompt: Look up a customer and return their active subscriptions, tickets, and recent orders

### Agent-driven event assistant

A fan-facing agent can answer what-is-on questions. Through Jentic, an agent resolves a request about upcoming matches into reading the event listings and their sessions and tickets.

Example prompt: Read the matches on sale and list their sessions and available tickets for a fan query

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/planos` | List subscription plans |
| GET | `/assinaturas` | List subscriptions |
| GET | `/clientes/{cliente_id}/ingressos` | List a customer's tickets |
| GET | `/anuncios` | List event announcements on sale |
| GET | `/anuncios/{anuncio_id}/ingressos` | List tickets for an event |
| GET | `/jogos` | List matches on sale |

## Key resources

- **Plans and benefits** — Subscription plans, add-ons, and benefits
- **Subscriptions** — Subscriptions and the customers who hold them
- **Customers** — Customer records with their tickets, orders, and subscriptions
- **Events** — Announcements and matches on sale, with sessions and tickets
- **Orders and tickets** — Orders placed against events and their tickets

## 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:** 47 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 82 / 100
  - Developer Experience & Jentic Compatibility: 84 / 100
  - AI-Readiness & Agent Experience: 22 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 67 / 100
- **View full report:** https://jentic.com/apis/cruzeirotickets.com.br/cruzeirotickets-com-br/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:** BaladAPP wiring is one partner token plus 20 read operations across plans, events, and orders. With Jentic One you install once, import them from the API Directory, and keep the token in one place.
- **Permission scoping:** Resources such as plan id, customer id, and event id are path parameters, so you can scope an agent to specific reads, for example event and ticket lookups, while withholding customer data.
- **Credential handling:** The partner token is stored encrypted by your own Jentic One instance and injected when a call runs, so it never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents find the right BaladAPP read through Jentic's intent search, matching a request like listing tickets for an event to the matching endpoint.

## Related APIs

- **Sympla** — Brazilian event and ticketing platform
- **Eventbrite** — Global event management and ticketing
- **SeatGeek** — Ticket marketplace and event discovery

## FAQ

### How does the BaladAPP partner API authenticate?

Each request carries a partner token in the `X-INTEGRACAO-API-TOKEN` header, as declared in the spec. Jentic One stores that token and injects it at execution time.

### Can I limit what my agent is allowed to do with BaladAPP?

Yes. Every operation is read-only, and you import only the ones an agent needs, so it can read event and ticket data while customer records stay out of scope.

### What events does the API expose?

It exposes announcements and matches that are on sale, each with its sessions, tickets, and the orders placed against it.

### Can the API sell tickets or create orders?

No. The partner interface is read-only: it reads plans, subscriptions, events, tickets, and orders but does not create or pay for them.

### Is BaladAPP specific to Cruzeiro?

Yes. It is the partner-integration layer for Cruzeiro's ticketing and subscription platform, served from the Cruzeiro partner host.