Frequently Asked Questions — Judit API

​

General

​

What is the Judit API?

The Judit API is a complete solution for automating judicial queries in Brazil. It allows you to query lawsuits by CPF, CNPJ, OAB, NAME, or CNJ, automatically track updates, download attachments (public and private), and securely manage court credentials.

---

​

Which courts are supported?

The Judit API supports the main Brazilian courts:

• State courts: TJSP, TJRJ, TJMG, TJRS, TJPR, TJSC, among others
• Federal courts: TRF1, TRF2, TRF3, TRF4, TRF5, TRF6
• Superior courts: STF, STJ, TST
• Specialized courts: Labor, Electoral, Military

See the complete list here.

---

​

How do I get an API Key?

Request your key via commercial WhatsApp or send an email to atendimento@judit.io. You will receive:

• Development API Key (free and limited)
• Integration documentation
• Access to the panel and technical support

---

​

Authentication

​

My API Key is not working

Check the following points:

1. The api-key header is present
2. The key is valid (not expired)
3. The key has permission for the endpoints used

---

​

Requests

​

How does attachment billing work?

• Attachment requests use search_type = lawsuit_attachment
• Only requests with search_type = lawsuit_cnj are charged
• Individual PDFs do not generate a separate charge

---

​

Does the historical query charge per document queried or per lawsuit returned?

It is charged for each 1,000 lawsuits returned per document queried.

---

​

Are lawsuits under judicial secrecy returned?

It depends. To access them, you must provide the lawyer’s credentials via the credentials vault.

---

​

Can a lawsuit have two instances?

Yes. The same lawsuit can proceed in more than one instance and, depending on the court, this can occur in two ways:

• Keeping the same case number, when the lawsuit moves to another instance without changing the original number.
• Generating a new case number, when the court creates a new number to represent the proceedings in another instance or some procedural development.

For this reason, Judit structures the response by separating each instance individually. When a lawsuit query identifies that the same case number exists in more than one instance, the API returns one object per instance within the results array. Each object represents the data for that lawsuit in that specific instance. The first object in the array, at position zero, represents the most recently identified instance. Additionally, when there is a new case number linked to the queried lawsuit and this relationship is available at the court as a related lawsuit, this information will be returned in the related_lawsuits field. This way, it is possible to differentiate the data for each instance and, when available, also identify new case numbers related to the same lawsuit.

---

​

Can I cancel a query?

No, once processing has started, it is not possible to cancel the execution.

---

​

I searched for a lawsuit and it was not found

Our platform delivers exactly the information available at the courts. If a valid lawsuit number is not found, this may occur for three main reasons:

• Incorrect number
• Lawsuit under judicial secrecy
• Lawsuit archived and unavailable at the court

---

​

I searched for a lawsuit and it is out of date

The update may not be instantaneous, but it should occur shortly afterward. If the issue persists, contact support.

---

​

How long can I access the query data?

Responses are stored for 6 months from the date of the request.

---

​

What is the difference between the private and secrecy_level fields?

• secrecy_level: indicates the level of secrecy (0 to 5) of the lawsuit
• private: indicates whether a case update is restricted to parties/lawyers

---

​

Tracking

​

How does tracking work?

Automatically notifies via webhook when:

​

Lawsuit tracking:

• New case updates
• Changes to parties
• Inclusion of attachments (when registered with with_attachments: true)
• Status changes

​

New cases:

• A new lawsuit is filed against the tracked document

---

​

What is new-case tracking?

Checks whether new lawsuits have been filed against the CPF/CNPJ/OAB/Name.

---

​

Does new-case tracking return phase and status?

No. For that, use the CNJ query (search_type = lawsuit_cnj).

---

​

Performance and Costs

​

How can I optimize queries?

• Use filters by date and court
• Disable attachments if they are not needed
• Implement local caching to avoid duplication

---

​

How can I reduce costs?

• Avoid unnecessary re-queries
• Use filters and caching
• Monitor consumption through the /requests route

---

​

What is the request limit (rate limit) and timeout?

• Rate limit: 3 req/s
• Creation timeout: 15 seconds
• Completion timeout: up to 1 hour (with automatic retry)

---

​

Integration

​

How do I integrate with my system?

1. Use webhooks to receive data
2. Automate requests based on events (e.g., customer registration)
3. Implement logging and error alerts

---

​

Other Features

​

What types of search are available?

• CNJ (lawsuit number)
• CPF/CNPJ/OAB/Name
• Historical lawsuit query
• Arrest warrant query
• Lawsuit count
• Check whether a lawsuit exists (True/False)
• Lawsuit query with masked result
• Query the number of lawsuits linked to a document
• Query by grouped data of a document
• Judit AI

---

​

Does the API cover extrajudicial proceedings?

We do not yet handle administrative proceedings.

---

​

Support

​

How do I get technical support?

• Documentation: docs.judit.io
• Email: atendimento@judit.io
• Service status: status.judit.io
• WhatsApp

---

​

How do I report a bug?

Include:

• request_id
• Date/Time of the error
• Error code
• Error description
• Environment (prod/dev)

---

​

Does Judit have an SLA?

​

Next Steps

• Glossary of terms
• Variable Mapping

Still have questions? Send an email to atendimento@judit.io or contact us via our support.