canonical: https://jentic.com/apis/jurisprudencias.ai/jurisprudencias # Jurisprudencias.ai API The Jurisprudencias.ai API searches published decisions from Brazilian courts, including the STF, STJ, and TST, the regional labor courts (TRT), the federal regional courts (TRF), the state courts (TJ), and the CARF tax appeals board. A full-text search runs against one court at a time with exact phrases in quotes, OR alternatives, and NOT or minus-term exclusions, filtered by publication or trial date ranges and sorted by either date. A lookup by case number returns the complete decision including its full ementa, and a courts listing reports which courts are available and how many decisions each holds. ## For AI agents Search Brazilian court decisions by text in the STF, STJ, TST, TRT, TRF, TJ courts, and CARF, filter by publication or trial date, and fetch a full decision by case number. ## Scope Does not handle case filing, docket tracking, or legislation text. Use for searching and retrieving published Brazilian court decisions only. ## Capabilities - List the Brazilian courts available for search with the number of decisions held for each - Search one court's decisions by text with exact phrases, OR alternatives, and NOT or minus-term exclusions - Narrow a decision search to a publication window with pub_from and pub_to or a trial window with trial_from and trial_to - Sort search results by publication_date or trial_date and page through them - Retrieve the full record of one decision, including its complete ementa, by case number ## Use cases ### Agent Legal Research via Jentic An AI agent assisting a Brazilian lawyer searches the relevant court's decisions for a legal thesis, using quoted phrases and exclusions to tighten the results, then fetches the full ementa of the strongest matches by case number. Through Jentic the agent discovers the search and lookup operations by intent and calls them with your stored token, so precedent research returns citable decisions rather than summaries from memory. Example prompt: Search the stj court for '"dano moral" atraso voo -internacional' published since 2024-01-01, sorted by publication_date, then look up the top three by case number and summarise each ementa ### Labor Court Precedent Monitoring Labor law teams run the same TST or regional TRT search on a schedule with a pub_from date set to the last run, so newly published decisions on a topic such as overtime or dismissal surface as they appear. Results sorted by publication_date put the newest rulings first. Example prompt: Search the tst court for 'horas extras' with pub_from set to last Monday and list the new decisions with their case numbers ### Citation Checking for Briefs Before filing, a paralegal or drafting assistant looks up every case number cited in a brief in the right court and confirms the decision exists and its ementa supports the point being made. The lookup returns the complete decision record, so the check does not depend on a court website. Example prompt: For each case number cited in the draft, look up the decision in its court and flag any number that returns no decision ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/courts` | List available courts | | GET | `/api/v1/courts/{court_id}/decisions` | Search a court's decisions by text | | GET | `/api/v1/courts/{court_id}/decisions/lookup` | Get a decision by case number | ## Key resources - **Courts** — Brazilian courts available for search, with decision counts. - **Decisions** — Published court decisions, searchable by text and date and retrievable by case number with the full ementa. ## 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: 63 / 100 - AI-Readiness & Agent Experience: 51 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 83 / 100 - **View full report:** https://jentic.com/apis/jurisprudencias.ai/jurisprudencias/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 Jurisprudencias.ai by hand means sending its jur_ bearer token, learning the court identifiers for the STF, STJ, TST, TRT, TRF, TJ courts, and CARF, and writing queries in its websearch syntax. Through Jentic you install once, import Jurisprudencias.ai from the API Directory, store the token once, and your agent calls it. - **Permission scoping:** Jurisprudencias.ai puts the court id in the URL path (`/api/v1/courts/{court_id}/decisions`), so a rule can pin your agent to one court, such as the STJ, and the search or lookup operations you pick. You choose the operations it may call, and the API itself is read-only. - **Credential handling:** Your Jurisprudencias.ai 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 'search Brazilian court decisions' or 'get a decision by case number', and Jentic returns the matching Jurisprudencias.ai operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **PACER API** — PACER searches US federal court cases; Jurisprudencias.ai searches Brazilian court decisions. - **AIRonline** — AIRonline covers Indian reported cases and acts; Jurisprudencias.ai covers Brazilian court decisions. - **Westlaw API** — Westlaw spans cases and statutes across common-law jurisdictions; Jurisprudencias.ai is focused on Brazilian courts. ## FAQ ### What authentication does the Jurisprudencias.ai API use? The Jurisprudencias.ai API authenticates with a bearer token prefixed jur_, sent in the Authorization header, per its OpenAPI spec. Tokens are issued from the API tokens page of your Jurisprudencias.ai account. Through Jentic the token is stored encrypted by your own Jentic One instance and injected at call time. ### Is there a Jurisprudencias.ai MCP server? You don't need an MCP server to give your agent Jurisprudencias.ai. Jentic connects it directly from the API Directory: import it, store your token once, and your agent searches and fetches court decisions as it needs to. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context. ### Can I limit what my agent is allowed to do with the Jurisprudencias.ai API? Yes. The court id is in the path, so you can write a rule that allows only the decision search and lookup under `/api/v1/courts/stj`/, letting a research agent work in the STJ and nowhere else. The API is read-only, so the main reason to scope is keeping an agent to the courts that matter for a matter, and every call it makes is logged. ### What search syntax does the Jurisprudencias.ai API support? Per its OpenAPI spec, the q parameter uses PostgreSQL websearch syntax: plain terms, "exact phrases" in quotes, OR between alternatives, and NOT or a leading minus to exclude a term. OR separates complete alternatives, and parentheses are ignored, so terms cannot be grouped. ### What are the rate limits for the Jurisprudencias.ai API? The Jurisprudencias.ai OpenAPI spec defines a 429 response for when the request limit is reached but does not publish the limit itself. Check https://jurisprudencias.ai for the current limits on your token. ### How do I search court decisions with the Jurisprudencias.ai API through Jentic? Search Jentic for an intent like 'search Brazilian court decisions', import Jurisprudencias.ai from the API Directory, and store your token once. Your agent then calls GET `/api/v1/courts/{court_id}/decisions` with a court id such as stj and a q search term, and fetches a full decision with GET `/api/v1/courts/{court_id}/decisions/lookup` and the case number in n. To run it on your own infrastructure, install Jentic One from its GitHub repo.