canonical: https://jentic.com/apis/klingo.app/klingo-informacoes

# Klingo App Klingo API Informações

The Klingo Informações API retrieves operational and financial reporting data from Klingo's clinic management system. It returns material and medication consumption for a month, financial expenses recorded in the finance module, production figures over a date range, and general system report data. Each endpoint is read-only and controlled by an application token in a request header.

## For AI agents

Read monthly consumption, recorded expenses, production figures, and system reports from Klingo's clinic management system.

## Scope

Does not create records, schedule appointments, or process payments. Use for reading Klingo consumption, expense, production, and report data only.

## Capabilities

- Retrieve material and medication consumption for a given month
- Pull recorded financial expenses for a month from the finance module
- Get production figures for a date range using the start and end parameters
- Read general system report data for the clinic

## Use cases

### Report clinic figures to an AI agent

An AI agent integration created through Jentic needs current operating numbers. The Klingo Informações API returns consumption, expense, production, and report data on demand, so the agent can answer questions about the clinic's month without a human exporting spreadsheets. Each call targets one read-only reporting endpoint.

Example prompt: Retrieve this month's consumption and expense figures and summarize them for the user

### Monthly consumption and expense review

A clinic manager wants a monthly snapshot of material usage and spending. The Klingo Informações API serves consumption for a month and the finance module's recorded expenses, both selected with the month parameter, so an automation can assemble the review without manual lookups.

Example prompt: Pull consumption and expenses for the current month and flag any month-over-month increase

### Production trend over a date range

Tracking output over time needs figures across a window, not just one month. The Klingo Informações API returns production figures filtered by the start and end parameters, letting an agent build a trend for a chosen date range from the clinic's own data.

Example prompt: Retrieve production figures between two dates and report the trend

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/consumos` | Retrieve material and medication consumption for a month |
| GET | `/despesas` | Retrieve recorded financial expenses for a month |
| GET | `/producao` | Retrieve production figures for a date range |
| GET | `/relatorio` | Retrieve system report data |

## Key resources

- **Consumption** — Material and medication consumption for a selected month
- **Expenses** — Financial expenses recorded in the clinic's finance module
- **Production** — Production figures over a chosen date range
- **Reports** — General system report data for the clinic

## 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:** 64 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 93 / 100
  - Developer Experience & Jentic Compatibility: 71 / 100
  - AI-Readiness & Agent Experience: 51 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/klingo.app/klingo-informacoes/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:** Wiring Klingo Informações by hand means setting the X-APP-TOKEN header on every call and matching the right base path for the info service. Through Jentic you install once, import Klingo Informações from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Every operation here is read-only, and the month and date filters travel in the query string, so rules bound which reporting operations your agent may call, not which month. You can allow consumption and expense reads while leaving production and report reads out unless you add them.
- **Credential handling:** Your Klingo application token 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 'get monthly consumption' or 'read clinic expenses', and Jentic returns the matching Klingo Informações operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Mixpanel** — Mixpanel reports on product and user analytics; Klingo Informações reports clinic consumption, expenses, and production.
- **Amplitude** — Amplitude is a product analytics platform; Klingo Informações is scoped to a clinic's operational reporting.
- **Metabase** — Metabase builds dashboards over your data; pair it with Klingo Informações to visualize the clinic figures it returns.

## FAQ

### What authentication does the Klingo Informações API use?

The Klingo Informações API authenticates with an application key sent in the X-APP-TOKEN request header, per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's prompt or logs.

### Can I read monthly consumption and expenses with the Klingo Informações API?

Yes. The consumption endpoint returns material and medication usage for a month and the expenses endpoint returns recorded finance-module expenses, both selected with the month parameter, so an agent can assemble a monthly snapshot.

### Can I get production figures for a date range?

Yes. The production endpoint accepts optional start and end parameters alongside the month, so an agent can request figures for a specific window and build a trend from the clinic's own data.

### How do I pull Klingo reporting data through Jentic?

Install Jentic One on your own infrastructure with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then import the Klingo Informações API from the API Directory and search for 'get monthly clinic consumption and expenses'. Store the application token once and your agent can read the reports. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Klingo Informações MCP server?

You don't need an MCP server to give your agent the Klingo Informações API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent calls it, with each reporting operation discovered on demand instead of loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Klingo Informações API?

Yes. Every operation here is read-only, so you choose which reporting endpoints the agent may call, such as consumption and expenses while leaving production and reports out. The month and date parameters travel in the query string, so a rule bounds which operations run rather than which month, and every action is recorded in an audit log.