> ## Documentation Index
> Fetch the complete documentation index at: https://docs.judit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoramento Processual

> Acompanhe automaticamente as movimentações de um processo específico pelo seu número CNJ. A Judit consulta o tribunal com a recorrência configurada e envia atualizações via webhook.

export const TrackingAnimation = () => <iframe sandbox="allow-scripts" scrolling="no" style={{
  width: '100%',
  height: '540px',
  border: 'none',
  borderRadius: '12px',
  display: 'block',
  margin: '20px 0'
}} srcDoc={`<!doctype html><html><head><meta charset="utf-8"><style>*{margin:0;padding:0;box-sizing:border-box}html,body{width:100%;height:100%;overflow:hidden;background:#090c0d}canvas{display:block;width:100%;height:100%}</style></head><body><canvas id="c"></canvas><script>(function(){
var A='#4FD1C5',J='#1FC16B',T='#E0A82E',M='#7A8599';
var BG='#090c0d',TXT='#e5e7eb',NF='#111827',PT='#0a1020';
var TOTAL=12.0;
var XP={app:0.13,judit:0.50,court:0.87};
var NW=88,NH=42;
var NODES=[{id:'app',label:'Sua App',col:A},{id:'judit',label:'Judit API',col:J},{id:'court',label:'Tribunal',col:T}];
var STEPS=[
  {fr:'app',to:'judit',label:'POST /tracking',note:'{lawsuit_cnj, recurrence:1}',col:A,ts:1.0,te:1.8,yp:0.30},
  {fr:'judit',to:'app',label:'201 {tracking_id}',note:'status: created',col:J,ts:2.3,te:3.1,yp:0.42},
  {sep:true,label:'↻  execução automática a cada N dias',yp:0.52},
  {fr:'judit',to:'court',label:'verifica no tribunal',note:'sem ação da sua aplicação',col:T,ts:4.8,te:5.6,yp:0.60},
  {fr:'court',to:'judit',label:'nova movimentação',note:'',col:J,ts:6.1,te:6.9,yp:0.72},
  {fr:'judit',to:'app',label:'webhook',note:'event: tracking_response',col:J,ts:7.4,te:8.2,yp:0.84}
];
var cv=document.getElementById('c');
function setup(){var dpr=Math.min(window.devicePixelRatio||1,2),r=cv.getBoundingClientRect(),W=r.width||window.innerWidth,H=r.height||window.innerHeight;cv.width=Math.max(1,W*dpr);cv.height=Math.max(1,H*dpr);var ctx=cv.getContext('2d');ctx.setTransform(dpr,0,0,dpr,0,0);return{ctx:ctx,w:W,h:H};}
function ease(t){return t<0.5?2*t*t:1-Math.pow(-2*t+2,2)/2;}
function rr(ctx,x,y,w,h,r){ctx.beginPath();ctx.moveTo(x+r,y);ctx.arcTo(x+w,y,x+w,y+h,r);ctx.arcTo(x+w,y+h,x,y+h,r);ctx.arcTo(x,y+h,x,y,r);ctx.arcTo(x,y,x+w,y,r);ctx.closePath();}
function gx(n,w){return n==='app'?w*XP.app:n==='judit'?w*XP.judit:w*XP.court;}
function eg(fr,to,w){var fx=gx(fr,w),tx=gx(to,w),d=tx>fx?1:-1;return{x1:fx+d*NW/2,x2:tx-d*NW/2,d:d};}
function dPkt(ctx,x,y,lbl,col){var pw=Math.max(36,lbl.length*6+14),ph=20;ctx.save();ctx.shadowColor=col;ctx.shadowBlur=18;rr(ctx,x-pw/2,y-ph/2,pw,ph,5);ctx.fillStyle=col;ctx.fill();ctx.shadowBlur=0;ctx.fillStyle=PT;ctx.font='bold 9px monospace';ctx.textAlign='center';ctx.textBaseline='middle';ctx.fillText(lbl,x,y+0.5);ctx.restore();}
function draw(ctx,w,h,t){
  var ct=t%TOTAL,bx1=w*0.02,bx2=w*0.98;
  ctx.fillStyle=BG;ctx.fillRect(0,0,w,h);
  var nodeY=h*0.21;
  ctx.fillStyle=J;ctx.font='bold 12px Inter,system-ui,sans-serif';ctx.textAlign='center';ctx.textBaseline='middle';ctx.fillText('Monitoramento Processual por CNJ',w/2,h*0.04);
  ctx.fillStyle=M;ctx.font='10px Inter,system-ui,sans-serif';ctx.fillText('Judit verifica o tribunal automaticamente e notifica via webhook',w/2,h*0.09);
  for(var i=0;i<NODES.length;i++){var n=NODES[i],lx=gx(n.id,w);ctx.save();ctx.strokeStyle=n.col;ctx.globalAlpha=0.35;ctx.lineWidth=1;ctx.setLineDash([4,7]);ctx.beginPath();ctx.moveTo(lx,nodeY+NH/2);ctx.lineTo(lx,h*0.94);ctx.stroke();ctx.restore();}
  for(var si=0;si<STEPS.length;si++){
    var s=STEPS[si],sy=h*s.yp;
    if(s.sep){ctx.save();ctx.strokeStyle='rgba(255,255,255,0.28)';ctx.lineWidth=1;ctx.setLineDash([3,5]);ctx.beginPath();ctx.moveTo(bx1,sy);ctx.lineTo(bx2,sy);ctx.stroke();ctx.fillStyle='rgba(255,255,255,0.05)';rr(ctx,bx1,sy-8,s.label.length*6.2+14,16,3);ctx.fill();ctx.fillStyle=M;ctx.font='10px monospace';ctx.textAlign='left';ctx.textBaseline='middle';ctx.fillText(s.label,bx1+5,sy);ctx.restore();continue;}
    var e=eg(s.fr,s.to,w),x1=e.x1,x2=e.x2,d=e.d,clx=(x1+x2)/2;
    var state=ct<s.ts?'pre':ct>s.te?'done':'live',alpha=state==='pre'?0.10:state==='done'?0.55:1.0;
    ctx.save();ctx.globalAlpha=alpha;ctx.strokeStyle=s.col;ctx.lineWidth=1.5;ctx.setLineDash([]);ctx.beginPath();ctx.moveTo(x1,sy);ctx.lineTo(x2,sy);ctx.stroke();ctx.fillStyle=s.col;ctx.beginPath();ctx.moveTo(x2,sy);ctx.lineTo(x2-d*7,sy-4);ctx.lineTo(x2-d*7,sy+4);ctx.closePath();ctx.fill();ctx.fillStyle=TXT;ctx.font='bold 10px monospace';ctx.textAlign='center';ctx.textBaseline='bottom';ctx.fillText(s.label,clx,sy-4);if(s.note){ctx.fillStyle=M;ctx.font='9px monospace';ctx.fillText(s.note,clx,sy-16);}ctx.restore();
    if(state==='live'){var p=ease((ct-s.ts)/(s.te-s.ts));dPkt(ctx,x1+(x2-x1)*p,sy+14,s.label,s.col);}
  }
  for(var i=0;i<NODES.length;i++){var nd=NODES[i],px=gx(nd.id,w);ctx.save();ctx.shadowColor=nd.col;ctx.shadowBlur=14;rr(ctx,px-NW/2,nodeY-NH/2,NW,NH,8);ctx.fillStyle=NF;ctx.fill();ctx.shadowBlur=0;ctx.strokeStyle=nd.col;ctx.lineWidth=1.8;ctx.stroke();ctx.fillStyle=nd.col;ctx.font='bold 11px Inter,system-ui,sans-serif';ctx.textAlign='center';ctx.textBaseline='middle';ctx.fillText(nd.label,px,nodeY);ctx.restore();}
}
var dim,t0;
function loop(){var t=(performance.now()-t0)/1000;draw(dim.ctx,dim.w,dim.h,t);requestAnimationFrame(loop);}
window.addEventListener('load',function(){dim=setup();t0=performance.now();loop();});
window.addEventListener('resize',function(){dim=setup();});
})()</script></body></html>`} />;

O **Monitoramento Processual** acompanha automaticamente um processo específico pelo seu número CNJ. Você cadastra o CNJ, define a recorrência (em dias) e a Judit consulta o tribunal para você. Sempre que houver novidade — nova movimentação, anexo ou decisão — você recebe a atualização via **webhook** ou e-mail.

> 🤖 Endpoint base: `POST https://tracking.production.judit.io/tracking` com `search.search_type: "lawsuit_cnj"`. O monitoramento roda em background, dentro da janela de melhor concorrência da Judit no tribunal. A primeira execução acontece nas 24 horas seguintes ao cadastro; as próximas seguem a recorrência definida em `recurrence` (em dias).

<TrackingAnimation />

## Quando usar

<CardGroup cols={2}>
  <Card title="Carteira ativa" icon="folder-open">
    Mantenha cada processo do escritório monitorado por CNJ, com webhooks chegando assim que houver andamento.
  </Card>

  <Card title="Acompanhamento de prazos" icon="clock">
    Receba alertas em tempo hábil sobre intimações, sentenças e despachos para nunca perder um prazo.
  </Card>

  <Card title="Atualização contínua" icon="rotate">
    Mantenha a base interna do escritório sempre sincronizada com o estado mais atual do processo no tribunal.
  </Card>

  <Card title="Alertas por palavra-chave" icon="bell">
    Use `notification_filters.step_terms` para receber alertas só quando movimentações específicas (ex.: "sentença", "intimação") aparecerem.
  </Card>
</CardGroup>

## Criando um Monitoramento

Para começar a monitorar um processo, você deve realizar uma solicitação POST para a rota `/tracking`.

## Payload da Solicitação

A solicitação POST deve incluir um payload com as seguintes propriedades:

* `fixed_time` (**obrigatório**): boolean. Define se o tracker roda sempre no mesmo horário do dia. Quando `true`, combine com `hour_range` (0-23) para fixar o horário. Quando `false`, a Judit escolhe a melhor janela de concorrência.

* `recurrence`: A recorrência em dias de atualização dos processos.

* `search` (**obrigatório**): Objeto que vai para a busca.
  * `search_type` (**obrigatório**): No contexto de monitoramento processual, o valor desse campo sempre será `lawsuit_cnj`.
  * `search_key`: O número do processo (Código CNJ) que você deseja buscar;

* `with_attachments` (opcional): Esse campo define se você quer trazer anexos referente ao processo buscado podendo ser **true** ou **false**

  * `Obs:` Os anexos só serão retornados caso o search\_type for **lawsuit\_cnj**.

* `search_params`: Um objeto que contém alguns parâmetros da busca como:
  * `lawsuit_instance` (opcional): Este parâmetro permite definir a instância em que deseja buscar o processo;

    `*Obs`: Caso o parâmetro lawsuit\_instance não seja especificado, a busca retornará automaticamente todas as instância encontradas para aquela mesma numeração de processo. Por exemplo, se o processo estiver tramitando tanto na primeira quanto na segunda instância, a busca cretornará as duas instâncias.

* `credential` (opcional): Objeto para o uso do cofre de credenciais.
  * `customer_key` (opcional): Permite passar a chave do usuário que você cadastrou no cofre de credenciais,caso não seja informado, a API tentará encontrar uma credencial cadastrada para a `customer_key` vazia.

* `notification_emails` (opcional): Array de strings fora do `search` que podem ser adicionados emails para os quais deseja receber notificação a cada atualização do monitoramento cadastrado.

* `step_terms`: Esta propriedade é um array de strings que permite filtrar as movimentações processuais com base em termos específicos. Quando utilizada em conjunto com o monitoramento via webhook, o usuário receberá notificações apenas se algum dos termos especificados for encontrado em uma nova movimentação processual.

Este parâmetro deve ser incluído dentro do objeto chamado notification\_filters.

Exemplo de payload com alguns filtros opcionais:

```json theme={null}
{
	"recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    },
    "notification_emails": ["teste@teste.com"]
	"notification_filters": {
		"step_terms": [
			'petição',
			'acordo'
		]
	}
}

```

Exemplo de payload sem filtros:

```json theme={null}

{
    "recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    }
}

```

Aqui está um exemplo de retorno esperado ao criar um monitoramento:

<Accordion title="Ver exemplo de resposta">
  ```json theme={null}
  {
      "tracking_id": "d923253e-45c1-46e5-ac70-164839d9851c",
      "user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
      "status": "created",
      "recurrence": 1,
      "notification_emails": [
          "teste@teste.com"
      ],
      "notification_filters": {
          "step_terms": [],
          "_id": "67ffb7a1062277871357743f"
      },
      "with_attachments": false,
      "plan_config_type": "simple_lawsuit_tracking",
      "fixed_time": false,
      "hour_range": 21,
      "search": {
          "search_type": "lawsuit_cnj",
          "search_key": "1111111-04.1111.1.11.1111",
          "response_type": "lawsuit",
          "search_params": {
              "filter": {},
              "pagination": {}
          }
      },
      "tags": {},
      "created_at": "2025-04-16T13:58:56.352Z",
      "updated_at": "2025-04-16T13:58:56.352Z"
  }
  ```
</Accordion>

<Note>
  Na resposta da criação do monitoramento, é retornado o campo `hour_range`, que indica o horário em que a consulta ao tribunal será realizada pela primeira vez. No exemplo acima, a primeira consulta está programada para ocorrer às 21 horas.
</Note>

Aqui está um exemplo de como usar esses parâmetros de consulta com curl:

```bash theme={null}
curl --location 'https://tracking.production.judit.io/tracking' \
--header 'api-key: <API-KEY>>' \
--header 'Content-Type: application/json' \
--data '{
    "recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    }
}'
```

<Note>
  O monitoramento irá ser iniciado a primeira vez, na melhor janela de
  concorrência de requisição ao tribunal, dentro das próximas 24 horas
  da data de criação.
</Note>

## Atualizando um Monitoramento

Para atualizar um monitoramento, você pode fazer uma solicitação PATCH para a rota `/tracking/{monitoramento}`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja atualizar.

Esta rota campos opcionais para atualização do tracking: `recurrence`, `tags` e o objeto de `search` para a busca com exceção de alguns campos.

Aqui está um exemplo de como fazer isso usando curl:

```bash theme={null}
curl -X PATCH "https://tracking.production.judit.io/tracking/{monitoramento}" \
-H "api-key: YOUR_API_KEY"
-d '{
  "recurrence": 5,
  "search": {
    "search_type": "lawsuit_cnj",
    "search_key": "1111111-04.1111.1.11.1111"
  }
}'
```

## Consultando Seus Monitoramentos

Para consultar todos os seus monitoramentos, você pode fazer uma solicitação GET para a rota `/tracking`. Esta rota aceita alguns parâmetros de consulta opcionais para paginar e filtrar os resultados:

`page`: Define a página dos resultados que você deseja consultar.

`page_size`: Define o número máximo de resultados que você deseja receber por página;

`search_type`: retorna monitoramentos do tipo de referência especificado **"cpf"**, **"cnpj"**, **"oab"**, **"lawsuit\_cnj"**, **name** ou **rji**;

`search_key`: retorna monitoramentos com a buscar relacionadas ao número do CPF, CNPJ, OAB ou processo informado;

`status`: retorna monitoramentos cujo status podem ser 'created', 'updating', 'updated', 'paused' ou 'deleted' ou mais de um de status \['updating', 'paused'];

Aqui está um exemplo de como consultar seus monitoramentos usando curl:

```bash theme={null}
curl -X GET "https://tracking.production.judit.io/tracking?page=1&page_size=10" \
-H "api-key: YOUR_API_KEY"
```

## Consultando a resposta gerada pelo monitoramento via pooling

### Exemplo de requisição (GET)

<CodeGroup>
  ```bash cURL theme={null}
  curl --location 'https://requests.production.judit.io/responses?page_size=100&request_id=<request_id>' \
    --header 'api-key: '"$JUDIT_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch(
    `https://requests.production.judit.io/responses?page_size=100&request_id=${requestId}`,
    { headers: { "api-key": process.env.JUDIT_API_KEY } }
  );
  const data = await res.json();
  console.log(data.page_data);
  ```

  ```php PHP theme={null}
  <?php
  $ch = curl_init('https://requests.production.judit.io/responses?page_size=100&request_id=' . urlencode($requestId));
  curl_setopt_array($ch, [
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => ['api-key: ' . getenv('JUDIT_API_KEY')],
  ]);
  echo curl_exec($ch);
  ```

  ```python Python theme={null}
  import os, requests

  resp = requests.get(
      "https://requests.production.judit.io/responses",
      params={"request_id": request_id, "page_size": 100},
      headers={"api-key": os.environ["JUDIT_API_KEY"]},
      timeout=15,
  )
  print(resp.json())
  ```

  ```go Go theme={null}
  package main

  import (
      "fmt"
      "io"
      "net/http"
      "net/url"
      "os"
  )

  func main() {
      requestID := "<request_id>"
      base, _ := url.Parse("https://requests.production.judit.io/responses")
      q := base.Query(); q.Set("request_id", requestID); q.Set("page_size", "100")
      base.RawQuery = q.Encode()
      req, _ := http.NewRequest("GET", base.String(), nil)
      req.Header.Set("api-key", os.Getenv("JUDIT_API_KEY"))
      res, _ := http.DefaultClient.Do(req)
      defer res.Body.Close()
      out, _ := io.ReadAll(res.Body); fmt.Println(string(out))
  }
  ```
</CodeGroup>

### Exemplos de resposta

<Accordion title="Ver exemplos de resposta (2 variantes)">
  <CodeGroup>
    ```json Exemplo de resposta simples (200 OK) theme={null}
    {
            "request_status": "completed",
            "page": 1,
            "page_count": 1,
            "all_pages_count": 1,
            "all_count": 1,
            "page_data": [
                {
                    "request_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
                    "response_id": "061c60b2-7fa9-4d20-87bb-1bedd31d5572",
                    "origin": "api",
                    "origin_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
                    "response_type": "lawsuit",
                    "response_data": {
                        "code": "9999999-99.9999.9.99.9999",
                        "justice": "8",
                        "tribunal": "26",
                        "instance": 1,
                        "distribution_date": "2019-02-15T16:00:00.000Z",
                        "judge": "Usuário teste",
                        "tribunal_acronym": "TJSP",
                        "secrecy_level": 0,
                        "tags": {
                            "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
                            "dictionary_updated_at": "2025-08-13T18:43:48.143Z"
                        },
                        "subjects": [
                            {
                                "code": "",
                                "name": "PAGAMENTO"
                            }
                        ],
                        "classifications": [
                            {
                                "code": "7",
                                "name": "PROCEDIMENTO COMUM CÍVEL"
                            }
                        ],
                        "courts": [
                            {
                                "name": "1ª Vara Cível"
                            }
                        ],
                        "parties": [
                            {
                                "main_document": "99999999999",
                                "name": "Usuário 2",
                                "side": "Passive",
                                "person_type": "Desconhecido",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cpf"
                                    }
                                ],
                                "lawyers": [
                                    {
                                        "name": "Usuário 3",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "main_document": "99999999999",
                                "name": "Usuário 4",
                                "side": "Active",
                                "person_type": "Desconhecido",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cnpj"
                                    }
                                ],
                                "lawyers": [
                                    {
                                        "name": "Usuário 5",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 4",
                                "side": "Active",
                                "person_type": "Desconhecido",
                                "documents": [],
                                "lawyers": [
                                    {
                                        "name": "Usuário 5",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 2",
                                "side": "Passive",
                                "person_type": "Desconhecido",
                                "documents": [],
                                "lawyers": [
                                    {
                                        "name": "Usuário 3",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 5",
                                "side": "Active",
                                "person_type": "Advogado",
                                "documents": []
                            },
                            {
                                "name": "Usuário 3",
                                "side": "Passive",
                                "person_type": "Advogado",
                                "documents": []
                            }
                        ],
                        "steps": [
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-07-16T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "56174b2e",
                                "content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
                                "steps_count": 32,
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            },
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-06-06T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "939794b9",
                                "content": "Arquivado Definitivamente",
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            },
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-06-06T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "423978eb",
                                "content": "Trânsito em Julgado às partes\nCertidão de trânsito em julgado e remessa ao arquivo geral",
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            }
                        ],
                        "attachments": [
                            {
                                "attachment_id": "60153051-1-1",
                                "attachment_date": "2019-02-15T16:00:41.000Z",
                                "attachment_name": "Petição (Outras)",
                                "extension": "pdf",
                                "status": "pending",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153057-5-1",
                                "attachment_date": "2019-02-15T16:00:42.000Z",
                                "attachment_name": "Instrumento de Procuração",
                                "extension": "pdf",
                                "status": "pending",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153061-6-1",
                                "attachment_date": "2019-02-15T16:00:43.000Z",
                                "attachment_name": "Guia",
                                "extension": "pdf",
                                "status": "pending",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153064-7-1",
                                "attachment_date": "2019-02-15T16:00:44.000Z",
                                "attachment_name": "Guia",
                                "extension": "pdf",
                                "status": "pending",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            }
                        ],
                        "related_lawsuits": [],
                        "crawler": {
                            "source_name": "JSaj - TJ - SP - Lawsuit - Auth - 1 instance",
                            "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
                            "weight": 10,
                            "updated_at": "2025-08-13T18:43:47.770Z"
                        },
                        "metadata": {},
                        "county": "VARA JUIZADO ESP. CIVEL CRIM. DE FERNANDOPOLIS",
                        "amount": 5798,
                        "state": "SP",
                        "city": "FERNANDOPOLIS",
                        "justice_description": "JUSTIÇA ESTADUAL",
                        "last_step": {
                            "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                            "lawsuit_instance": 1,
                            "step_date": "2019-07-16T00:00:00.000Z",
                            "private": false,
                            "tags": {
                                "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805"
                            },
                            "step_id": "56174b2e",
                            "content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
                            "steps_count": 32
                        },
                        "phase": "Execução ou cumprimento",
                        "status": "Ativo",
                        "name": "Usuário 4 X Usuário 2",
                        "created_at": "2025-08-13T18:43:51.016Z",
                        "updated_at": "2025-08-13T18:43:51.016Z",
                        "free_justice": false
                    },
                    "user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
                    "created_at": "2025-08-13T18:40:54.982Z",
                    "request_created_at": "2025-08-13T18:40:54.037Z",
                    "tags": {
                        "debug": true,
                        "dashboard_id": null,
                        "cached_response": false,
                        "cached": false
                    }
                }
            ]
        }

    ```

    ```json Exemplo de resposta com anexo (200 OK) theme={null}
    {
            "request_status": "completed",
            "page": 1,
            "page_count": 1,
            "all_pages_count": 1,
            "all_count": 1,
            "page_data": [
                {
                    "request_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
                    "response_id": "061c60b2-7fa9-4d20-87bb-1bedd31d5572",
                    "origin": "api",
                    "origin_id": "03abbf28-822e-45a0-a22c-098fbe157aa4",
                    "response_type": "lawsuit",
                    "response_data": {
                        "code": "9999999-99.9999.9.99.9999",
                        "justice": "8",
                        "tribunal": "26",
                        "instance": 1,
                        "distribution_date": "2019-02-15T16:00:00.000Z",
                        "judge": "Usuário teste",
                        "tribunal_acronym": "TJSP",
                        "secrecy_level": 0,
                        "tags": {
                            "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
                            "dictionary_updated_at": "2025-08-13T18:43:48.143Z"
                        },
                        "subjects": [
                            {
                                "code": "",
                                "name": "PAGAMENTO"
                            }
                        ],
                        "classifications": [
                            {
                                "code": "7",
                                "name": "PROCEDIMENTO COMUM CÍVEL"
                            }
                        ],
                        "courts": [
                            {
                                "name": "1ª Vara Cível"
                            }
                        ],
                        "parties": [
                            {
                                "main_document": "99999999999",
                                "name": "Usuário 2",
                                "side": "Passive",
                                "person_type": "Desconhecido",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cpf"
                                    }
                                ],
                                "lawyers": [
                                    {
                                        "name": "Usuário 3",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "main_document": "99999999999",
                                "name": "Usuário 4",
                                "side": "Active",
                                "person_type": "Desconhecido",
                                "documents": [
                                    {
                                        "document": "99999999999",
                                        "document_type": "cnpj"
                                    }
                                ],
                                "lawyers": [
                                    {
                                        "name": "Usuário 5",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 4",
                                "side": "Active",
                                "person_type": "Desconhecido",
                                "documents": [],
                                "lawyers": [
                                    {
                                        "name": "Usuário 5",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 2",
                                "side": "Passive",
                                "person_type": "Desconhecido",
                                "documents": [],
                                "lawyers": [
                                    {
                                        "name": "Usuário 3",
                                        "documents": []
                                    }
                                ]
                            },
                            {
                                "name": "Usuário 5",
                                "side": "Active",
                                "person_type": "Advogado",
                                "documents": []
                            },
                            {
                                "name": "Usuário 3",
                                "side": "Passive",
                                "person_type": "Advogado",
                                "documents": []
                            }
                        ],
                        "steps": [
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-07-16T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "56174b2e",
                                "content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
                                "steps_count": 32,
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            },
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-06-06T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "939794b9",
                                "content": "Arquivado Definitivamente",
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            },
                            {
                                "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                                "lawsuit_instance": 1,
                                "step_date": "2019-06-06T00:00:00.000Z",
                                "private": false,
                                "tags": {
                                    "crawl_id": "36fc0ffd-98fa-4990-bd6f-6a82e5565119"
                                },
                                "step_id": "423978eb",
                                "content": "Trânsito em Julgado às partes\nCertidão de trânsito em julgado e remessa ao arquivo geral",
                                "created_at": "2025-07-09T13:48:33.114Z",
                                "updated_at": "2025-08-11T18:57:39.041Z"
                            }
                        ],
                        "attachments": [
                            {
                                "attachment_id": "60153051-1-1",
                                "attachment_date": "2019-02-15T16:00:41.000Z",
                                "attachment_name": "Petição (Outras)",
                                "extension": "pdf",
                                "status": "done",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153057-5-1",
                                "attachment_date": "2019-02-15T16:00:42.000Z",
                                "attachment_name": "Instrumento de Procuração",
                                "extension": "pdf",
                                "status": "done",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153061-6-1",
                                "attachment_date": "2019-02-15T16:00:43.000Z",
                                "attachment_name": "Guia",
                                "extension": "pdf",
                                "status": "done",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            },
                            {
                                "attachment_id": "60153064-7-1",
                                "attachment_date": "2019-02-15T16:00:44.000Z",
                                "attachment_name": "Guia",
                                "extension": "pdf",
                                "status": "done",
                                "tags": {
                                    "crawl_id": "424cd251-3d1f-407e-9d17-cb61219545aa"
                                },
                                "user_data": null
                            }
                        ],
                        "related_lawsuits": [],
                        "crawler": {
                            "source_name": "JSaj - TJ - SP - Lawsuit - Auth - 1 instance",
                            "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805",
                            "weight": 10,
                            "updated_at": "2025-08-13T18:43:47.770Z"
                        },
                        "metadata": {},
                        "county": "VARA JUIZADO ESP. CIVEL CRIM. DE FERNANDOPOLIS",
                        "amount": 5798,
                        "state": "SP",
                        "city": "FERNANDOPOLIS",
                        "justice_description": "JUSTIÇA ESTADUAL",
                        "last_step": {
                            "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                            "lawsuit_instance": 1,
                            "step_date": "2019-07-16T00:00:00.000Z",
                            "private": false,
                            "tags": {
                                "crawl_id": "a9b6820a-6c84-4db5-b4f4-2f1909aa3805"
                            },
                            "step_id": "56174b2e",
                            "content": "Início da Execução Juntado\n0003695-16.2019.8.26.0189 - Cumprimento de sentença",
                            "steps_count": 32
                        },
                        "phase": "Execução ou cumprimento",
                        "status": "Ativo",
                        "name": "Usuário 4 X Usuário 2",
                        "created_at": "2025-08-13T18:43:51.016Z",
                        "updated_at": "2025-08-13T18:43:51.016Z",
                        "free_justice": false
                    },
                    "user_id": "7f8065a3-4891-428d-9456-dedfc12ff850",
                    "created_at": "2025-08-13T18:40:54.982Z",
                    "request_created_at": "2025-08-13T18:40:54.037Z",
                    "tags": {
                        "debug": true,
                        "dashboard_id": null,
                        "cached_response": false,
                        "cached": false
                    }
                }
            ]
        }

    ```
  </CodeGroup>
</Accordion>

## Recebendo a resposta enviada por webhook

<Info>
  👉 *[Aprenda a configurar e receber Webhooks aqui](/webhook/callbacks)*
</Info>

**Obs**: Todas movimentações serão notificadas via webhook contendo o processo por completo, incrementando as últimas movimentações.

<Accordion title="Ver exemplo de resposta">
  ```json theme={null}
  {
    "_id": {
      "$oid": "65f0efe046ad3bda5b27be2d"
    },
    "callback_id": "be1406d9-d62d-402d-8e0e-8684044645de",
    "event_type": "response_created",
    "reference_type": "tracking",
    "reference_id": "8744cfea-f9d4-4e83-801e-bc05003ebf6b",
    "user_id": "ac98336e-c493-4609-a058-cf7114f7a2ed",
    "webhook_id": "2f82201d-1439-436d-8c6a-2e6b3e36a54f",
    "payload": {
      "request_id": "7d50b66c-3e86-4d0b-95af-5ff7561d18ff",
      "response_id": "12576767-d3ea-4ea2-8805-6f2a73ef3439",
      "response_type": "lawsuit",
      "response_data": {
        "code": "9999999-99.9999.9.99.9999",
        "justice": "8",
        "tribunal": "05",
        "instance": 1,
        "distribution_date": "2024-01-17T15:43:39.000Z",
        "judge": "AUGUSTO YUZO JOUTI",
        "tribunal_acronym": "TJBA",
        "secrecy_level": 0,
        "tags": {
          "crawl_id": "f9b29daf-4cd4-48e9-97cd-0cee91400765"
        },
        "subjects": [
          {
            "code": "7779",
            "name": "INDENIZAÇÃO POR DANO MORAL"
          },
          {
            "code": "6220",
            "name": "RESPONSABILIDADE DO FORNECEDOR"
          },
          {
            "code": "1156",
            "name": "DIREITO DO CONSUMIDOR"
          }
  	],
  }
  ```
</Accordion>

<Warning>
  Para cadastrar seu webhook, entre em contato com a equipe de [suporte](https://api.whatsapp.com/send/?phone=5521976748865) e solicite a criação. Alternativamente, o webhook também pode ser especificado adicionando o parâmetro callback\_url no payload da requisição, conforme o exemplo abaixo:
</Warning>

```json theme={null}
{
    "recurrence": 1,
    "search": {
        "search_type": "lawsuit_cnj",
        "search_key": "1111111-04.1111.1.11.1111"
    },
    "callback_url": "https://webhook.site/b0ac6522-5bfc-42fa-bebf-a8c2b5ec0999",
    "notification_emails": ["teste@teste.com"],
    "with_attachments": true
}
```

## Consultando Informações de um Monitoramento

Para consultar todas as informações sobre um monitoramento específico, você pode fazer uma solicitação GET para a rota `/tracking/{monitoramento}`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja consultar.

Aqui está um exemplo de como fazer isso usando curl:

```bash theme={null}
curl -X GET "https://tracking.production.judit.io/tracking?tracking_id=15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9" \
-H "api-key: YOUR_API_KEY"
```

Aqui está o retorno esperado:

```json theme={null}
{
 "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
 "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
 "status": "updated",
 "recurrence": 1,
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "response_type": "lawsuit",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "tracked_items_count": 0,
 "tracked_items_steps_count": 0,
 "tags": {},
 "created_at": "2024-02-21T18:26:38.499Z",
 "updated_at": "2024-02-21T18:26:38.499Z"
}
```

## Consultando histórico de um monitoramento

Para consultar o histórico de respostas geradas por um monitoramento específico, faça uma solicitação GET para a rota /tracking/{monitoramento}, substituindo {monitoramento} pelo ID do monitoramento desejado.

Você pode filtrar os resultados usando os parâmetros `created_at_gte` e `created_at_lte`, onde:

`created_at_gte`: define a data inicial da consulta.
`created_at_lte`: define a data final da consulta.

Aqui está um exemplo de como fazer isso usando curl:

```bash theme={null}
curl --location 'https://requests.production.judit.io/responses/tracking/<TRACKING_ID>?order=asc&page=1&page_size=50&created_at_gte=2024-03-05T00%3A00%3A00&created_at_lte=2025-03-11T00%3A00%3A00' \
--header 'api-key: <API-KEY>'
```

Aqui está o retorno esperado:

<Accordion title="Ver exemplo de resposta">
  ```json theme={null}
  {
      "request_status": "completed",
      "page": 1,
      "page_count": 2,
      "all_pages_count": 1,
      "all_count": 2,
      "page_data": [
          {
              "request_id": "644a4759-1ae2-48a4-8b09-76afffc75849393",
              "response_id": "a37ca823-e1d2-4de4-a973-ec9e859d21ed",
              "origin": "tracking",
              "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
              "response_type": "lawsuit",
              "response_data": {
                  "amount": 13687.36,
                  "attachments": [
                      {
                          "attachment_id": "f2f14dca-5b3f-aba2-a9bd95bd367f",
                          "attachment_date": "2025-01-22T15:19:46.000Z",
                          "attachment_name": "id_externo_3",
                          "content": "CÁLCULOS",
                          "extension": "octet-stream",
                          "status": "done",
                          "tags": {
                              "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                          },
                          "user_data": null
                      },
                      {
                          "attachment_id": "e26be17f-06ba-9f0c-7fc840e092b1",
                          "attachment_date": "2025-01-22T15:19:46.000Z",
                          "attachment_name": "id_externo_2",
                          "content": "CERTIDÃO DE DÍVIDA ATIVA",
                          "extension": "octet-stream",
                          "status": "done",
                          "tags": {
                              "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                          },
                          "user_data": null
                      },
                      {
                          "attachment_id": "54e833a9-58a3-9484-0e6e1cb6c457",
                          "attachment_date": "2025-01-22T15:19:46.000Z",
                          "attachment_name": "id_externo_1",
                          "content": "PETIÇÃO INICIAL",
                          "step_id": "ac8ea79b",
                          "extension": "octet-stream",
                          "status": "done",
                          "tags": {
                              "crawl_id": "bf565435-68c6-4b6b-8004-6533cbd0fb8e"
                          },
                          "user_data": null
                      }
                  ],
                  "classifications": [
                      {
                          "code": "1116",
                          "name": "EXECUÇÃO FISCAL"
                      }
                  ],
                  "code": "3000133-12.2025.8.19.0001",
                  "county": "TESTE TRIBUNAL",
                  "city": "RIO DE JANEIRO",
                  "state": "RJ",
                  "area": "NÃO INFORMADO",
                  "justice_description": "JUSTIÇA ESTADUAL",
                  "created_at": "2025-01-23T16:09:20.134Z",
                  "updated_at": "2025-01-24T16:10:56.948Z",
                  "metadata": {},
                  "courts": [
                      {
                          "code": "7798",
                          "name": "TESTE RETORNO TRIUNAL"
                      }
                  ],
                  "crawler": {
                      "source_name": "JTJ - BR - Document / Lawsuit - Auth",
                      "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b",
                      "weight": 0,
                      "updated_at": "2025-01-24T16:10:50.024Z"
                  },
                  "distribution_date": "2025-01-22T15:19:46.000Z",
                  "free_justice": false,
                  "instance": 1,
                  "justice": "8",
                  "last_step": {
                      "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                      "lawsuit_instance": 1,
                      "private": false,
                      "step_id": "91dc5544",
                      "step_date": "2025-01-22T18:40:18.000Z",
                      "content": "Conclusos para decisão/despacho",
                      "step_type": "51",
                      "tags": {
                          "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                      },
                      "steps_count": 1
                  },
                  "name": "USUÁRIO EXEMPLO 1 X USUÁRIO EXEMPLO 2",
                  "parties": [
                      {
                          "side": "Active",
                          "name": "USUÁRIO EXEMPLO 1",
                          "main_document": "99999999999",
                          "person_type": "EXEQUENTE",
                          "entity_type": "company",
                          "documents": [
                              {
                                  "document": "99999999999999",
                                  "document_type": "CNPJ"
                              }
                          ],
                          "lawyers": [
                              {
                                  "name": "USUÁRIO EXEMPLO 3",
                                  "main_document": "99999999999",
                                  "documents": [
                                      {
                                          "document": "99999999999",
                                          "document_type": "cpf"
                                      }
                                  ]
                              }
                          ],
                          "tags": {
                              "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                          }
                      },
                      {
                          "side": "Passive",
                          "name": "USUÁRIO EXEMPLO 2",
                          "main_document": "99999999999",
                          "person_type": "EXECUTADO",
                          "entity_type": "company",
                          "documents": [
                              {
                                  "document": "99999999999999",
                                  "document_type": "CNPJ"
                              }
                          ],
                          "tags": {
                              "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b"
                          },
                          "lawyers": []
                      }
                  ],
                  "related_lawsuits": [],
                  "secrecy_level": 0,
                  "status": "Ativo",
                  "phase": "Inicial",
                  "steps": [],
                  "subjects": [
                      {
                          "code": "6017",
                          "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                      },
                      {
                          "code": "5953",
                          "name": "IPVA - IMPOSTO SOBRE PROPRIEDADE DE VEÍCULOS AUTOMOTORES"
                      }
                  ],
                  "tags": {
                      "crawl_id": "8b485368-4315-4247-8314-a6169aa46e0b",
                      "dictionary_updated_at": "2025-01-24T16:10:50.384Z"
                  },
                  "tribunal": "19",
                  "tribunal_acronym": "TJRJ"
              },
              "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
              "created_at": "2025-01-24T16:10:53.278Z",
              "tags": {
                  "dashboard_id": null
              }
          },
          {
              "request_id": "32e0cbb6-71ed-4165-81d5-08ef4dcf80c6",
              "response_id": "a6690acb-0856-4e4d-ae69-c8d808ce7d9e",
              "origin": "tracking",
              "origin_id": "cfb61e6e-f2bd-4375-8c87-373405cac6db",
              "response_type": "lawsuit",
              "response_data": {
                  "amount": 17456.15,
                  "attachments": [],
                  "classifications": [
                      {
                          "code": "1116",
                          "name": "EXECUÇÃO FISCAL"
                      }
                  ],
                  "code": "3000233-64.2025.8.19.0001",
                  "county": "CAPITAL 12 VARA FAZ PUBLICA",
                  "city": "RIO DE JANEIRO",
                  "state": "RJ",
                  "area": "NÃO INFORMADO",
                  "justice_description": "JUSTIÇA ESTADUAL",
                  "created_at": "2025-01-27T16:09:19.112Z",
                  "updated_at": "2025-01-27T16:09:19.112Z",
                  "metadata": {},
                  "courts": [
                      {
                          "code": "79705",
                          "name": " CAPITAL 17 FAZ PUBLICA"
                      }
                  ],
                  "crawler": {
                      "source_name": "JTJ - BR - Document / Lawsuit - Auth",
                      "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1",
                      "weight": 0,
                      "updated_at": "2025-01-27T16:09:18.570Z"
                  },
                  "distribution_date": "2025-01-24T17:08:03.000Z",
                  "free_justice": false,
                  "instance": 1,
                  "justice": "8",
                  "last_step": {
                      "lawsuit_cnj": "9999999-99.9999.9.99.9999",
                      "lawsuit_instance": 1,
                      "private": false,
                      "step_id": "5d93c333",
                      "step_date": "2025-01-27T10:30:20.000Z",
                      "content": "Expedição de Carta pelo Correio - 1 carta",
                      "step_type": "60",
                      "tags": {
                          "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                      },
                      "steps_count": 1
                  },
                  "name": "usuário teste 1 X usuário teste 2",
                  "parties": [
                      {
                          "side": "Active",
                          "name": "USUÁRIO 1",
                          "main_document": "99999999999999",
                          "person_type": "EXEQUENTE",
                          "entity_type": "company",
                          "documents": [
                              {
                                  "document": "99999999999999",
                                  "document_type": "CNPJ"
                              }
                          ],
                          "lawyers": [
                              {
                                  "name": "USUÁRIO 2",
                                  "main_document": "99999999999",
                                  "documents": [
                                      {
                                          "document": "99999999999",
                                          "document_type": "cpf"
                                      }
                                  ]
                              }
                          ],
                          "tags": {
                              "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                          }
                      },
                      {
                          "side": "Passive",
                          "name": "USUÁRIO 2",
                          "main_document": "99999999999999",
                          "person_type": "EXECUTADO",
                          "entity_type": "company",
                          "documents": [
                              {
                                  "document": "99999999999999",
                                  "document_type": "CNPJ"
                              }
                          ],
                          "tags": {
                              "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1"
                          },
                          "lawyers": []
                      }
                  ],
                  "related_lawsuits": [],
                  "secrecy_level": 0,
                  "status": "Ativo",
                  "phase": "Inicial",
                  "steps": [],
                  "subjects": [
                      {
                          "code": "6017",
                          "name": "DÍVIDA ATIVA (EXECUÇÃO FISCAL)"
                      },
                      {
                          "code": "5953",
                          "name": "IPVA - IMPOSTO SOBRE PROPRIEDADE DE VEÍCULOS AUTOMOTORES"
                      }
                  ],
                  "tags": {
                      "crawl_id": "f9efa845-8501-4804-9595-f01c25fd7ba1",
                      "dictionary_updated_at": "2025-01-27T16:09:19.635Z"
                  },
                  "tribunal": "19",
                  "tribunal_acronym": "TJRJ"
              },
              "user_id": "98c1d8e0-94bf-43ab-b298-a7158a9efbc9",
              "created_at": "2025-01-27T16:09:18.752Z",
              "tags": {
                  "dashboard_id": null
              }
          }
      ]
  }
  ```
</Accordion>

## Pausando um Monitoramento

Para pausar um monitoramento, você pode fazer uma solicitação POST para a rota `/tracking/{monitoramento}/pause`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja pausar.

Aqui está um exemplo de como pausar o monitoramento usando o curl:

```bash theme={null}
curl -X POST "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9/pause" \
-H "api-key: YOUR_API_KEY"
```

Aqui está um exemplo de retorno do monitoramento pausado:

```json theme={null}
{
 "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
 "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
 "status": "paused",
 "recurrence": 1,
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "response_type": "lawsuit",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "tracked_items_count": 0,
 "tracked_items_steps_count": 0,
 "tags": {},
 "created_at": "2024-02-21T18:26:38.499Z",
 "updated_at": "2024-02-21T18:26:38.499Z"
}
```

## Reativando um Monitoramento

Para reativar um monitoramento pausado, você pode fazer uma solicitação POST para a rota `/tracking/{monitoramento}/resume`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja reativar.

Aqui está um exemplo de como reativar um monitoramento usando curl:

```bash theme={null}
curl -X POST "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9/resume" \
-H "api-key: YOUR_API_KEY"
```

Aqui está um exemplo de retorno do monitoramento **ativo**

```json theme={null}
{
 "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
 "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
 "status": "updated",
 "recurrence": 1,
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "response_type": "lawsuit",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "tracked_items_count": 0,
 "tracked_items_steps_count": 0,
 "tags": {},
 "created_at": "2024-02-21T18:26:38.499Z",
 "updated_at": "2024-02-21T18:26:38.499Z"
}
```

## Deletando um Monitoramento

Para deletar um monitoramento, você pode fazer uma solicitação DELETE para a rota `/tracking/{monitoramento}`, substituindo `{monitoramento}` pelo ID do monitoramento que você deseja excluir.

<Warning>
  A exclusão é **definitiva**: o tracker para de rodar imediatamente, suas execuções futuras são canceladas e o histórico de respostas vinculadas a ele permanece consultável apenas via [`GET /responses`](/api-reference/endpoint/responses/find-many) com o `origin_id` antigo. Se você só quer suspender temporariamente, use [Pausar](#pausando-um-monitoramento) e depois [Reativar](#reativando-um-monitoramento).
</Warning>

Aqui está um exemplo de como deletar um monitoramento usando curl:

```bash theme={null}
curl -X DELETE "https://tracking.production.judit.io/tracking/15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9" \
-H "api-key: YOUR_API_KEY"
```

Aqui está um exemplo de retorno do monitoramento deletado:

```json theme={null}
{
 "tracking_id": "15d632c6-a2ab-40c1-bfc5-d8f7bf8d8dd9",
 "user_id": "82082593-c664-4d7b-b174-2f0dc4791daf",
 "status": "deleted",
 "recurrence": 1,
 "search": {
  "search_type": "lawsuit_cnj",
  "search_key": "9999999-99.9999.9.99.9999",
  "response_type": "lawsuit",
  "search_params": {
   "filter": {},
   "pagination": {}
  }
 },
 "tracked_items_count": 0,
 "tracked_items_steps_count": 0,
 "tags": {},
 "created_at": "2024-02-21T18:26:38.499Z",
 "updated_at": "2024-02-21T18:26:38.499Z"
}
```

## Próximos passos

* **[Monitoramento por Documento](/tracking/tracking-document)** — detecte novos processos vinculados a CPF, CNPJ ou OAB.
* **[Monitoramento Customizado](/tracking/tracking-custom)** — filtros avançados (tribunal, valor, classe, fase) sobre tracking por documento.
* **[Webhook & Callbacks](/webhook/callbacks)** — comportamento de entrega, idempotência e reentregas.
* **[Monitoramento em Massa](/guides/monitoramento-massa)** — receita prática para portfólios de 10k+ processos.
