> ## Documentation Index > Fetch the complete documentation index at: https://docs.sherlocker.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Processos judiciais de uma empresa > Retorna processos vinculados a um CNPJ com classe, assunto, partes, advogados e ate 10 movimentacoes recentes por processo. Suporta paginacao por `limit`/`offset` e filtro por `categorias`. ## OpenAPI ````yaml /openapi/processos.json get /processos/cnpj/{cnpj} openapi: 3.0.0 info: title: Sherlocker Processos API description: >- Inteligencia processual em multiplos tribunais (SEAM, ESAJ, Escavador, TRF2). Retorna processos com classe, assunto, partes, movimentacoes e documentos, por CPF ou CNPJ. version: '1.0' servers: - url: https://221b-api.sherlocker.com.br/api/v1 security: - tokenAuth: [] paths: /processos/cnpj/{cnpj}: get: tags: - Processos summary: Processos judiciais de uma empresa description: >- Retorna processos vinculados a um CNPJ com classe, assunto, partes, advogados e ate 10 movimentacoes recentes por processo. Suporta paginacao por `limit`/`offset` e filtro por `categorias`. operationId: getProcessosByCnpj parameters: - name: cnpj in: path required: true description: CNPJ (14 digitos) schema: type: string example: '12345678000199' - name: limit in: query required: false description: Maximo de processos por pagina (default 50, max 200) schema: type: integer default: 50 - name: offset in: query required: false description: Offset para paginacao (default 0) schema: type: integer default: 0 - name: categorias in: query required: false description: >- Filtrar por categorias (comma-separated). Ex: falencia,recuperacao-judicial schema: type: string example: falencia,recuperacao-judicial - name: realtime in: query required: false description: >- Se "true", dispara scraping em tempo real nos tribunais e-SAJ e retorna `{ realtime: { job_id, status, poll_url } }` para polling em /processos/jobs/{jobId}. schema: type: string example: 'true' responses: '200': description: Processos encontrados content: application/json: schema: $ref: '#/components/schemas/ProcessosResponse' example: documento: 12.345.678/0001-99 tipo_documento: CNPJ total: 2 limit: 50 offset: 0 processos: - numero_processo: '00054321020218260100' numero_formatado: 0005432-10.2021.8.26.0100 tribunal: tjsp classe_codigo: 12 classe_nome: Execução Fiscal grau: G1 data_ajuizamento: '2021-05-20' orgao_julgador: 2ª Vara de Execuções Fiscais assuntos: Dívida Ativa - ICMS valor_acao: 25000 partes: - nome: Fazenda Pública do Estado de São Paulo documento: 46.395.000/0001-39 polo: Ativo tipo: Pessoa Jurídica - nome: Silva Comércio Ltda documento: 12.345.678/0001-99 polo: Passivo tipo: Pessoa Jurídica advogados: - nome: Paulo Roberto Procurador oab: SP987654 polo: Ativo documento: '' movimentacoes: - data: '2021-08-10' descricao: Penhora online realizada complemento: 'Valor bloqueado: R$ 25.000,00' - data: '2021-06-15' descricao: Citação por edital complemento: '' - data: '2021-05-20' descricao: Distribuído complemento: '' - numero_processo: '10087654320208020001' numero_formatado: 1008765-43.2020.8.02.0001 tribunal: trt2 classe_codigo: 985 classe_nome: Reclamação Trabalhista grau: G1 data_ajuizamento: '2020-11-10' orgao_julgador: 15ª Vara do Trabalho de São Paulo assuntos: Rescisão Indireta valor_acao: 45000 partes: - nome: Maria Fernanda Santos documento: 999.888.777-66 polo: Ativo tipo: Pessoa Física - nome: Silva Comércio Ltda documento: 12.345.678/0001-99 polo: Passivo tipo: Pessoa Jurídica advogados: - nome: Carla Trabalhista oab: SP111222 polo: Ativo documento: 777.888.999-00 movimentacoes: - data: '2021-02-15' descricao: Acordo homologado complemento: 'Valor: R$ 45.000,00' '400': description: Parametro invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Token ausente ou invalido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: ProcessosResponse: type: object properties: documento: type: string description: Documento consultado, formatado (CPF/CNPJ) tipo_documento: type: string description: Tipo do documento consultado enum: - CPF - CNPJ categorias: type: array description: Presente apenas quando o filtro `categorias` e informado items: type: object properties: slug: type: string label: type: string total: type: integer description: Total de processos encontrados para o documento limit: type: integer description: Limite aplicado (max 200) offset: type: integer description: Offset aplicado processos: type: array items: $ref: '#/components/schemas/ProcessoDetalhado' ErrorResponse: type: object properties: success: type: boolean example: false erro: type: object properties: codigo: type: string description: 'Codigo do erro (ex: VALIDATION_ERROR, NOT_FOUND, UNAUTHORIZED)' example: VALIDATION_ERROR mensagem: type: string description: Mensagem descritiva do erro example: CPF invalido ProcessoDetalhado: type: object description: >- Processo retornado pela listagem por CPF/CNPJ. Todos os campos sao planos (nao ha objeto `processo` aninhado). properties: numero_processo: type: string description: Numero unificado CNJ (digitos, sem mascara) numero_formatado: type: string description: 'Numero formatado (ex: 0001234-56.2020.8.26.0100)' tribunal: type: string description: Sigla do tribunal classe_codigo: type: integer description: Codigo CNJ da classe processual classe_nome: type: string description: Nome da classe (Title Case) grau: type: string description: 'Grau de jurisdicao (ex: G1, G2)' data_ajuizamento: type: string description: Data ISO (YYYY-MM-DD) orgao_julgador: type: string description: Vara ou turma (Title Case) assuntos: type: string description: Assuntos do processo valor_acao: type: number nullable: true description: Valor da acao em reais; null quando nao declarado partes: type: array items: $ref: '#/components/schemas/Parte' advogados: type: array items: $ref: '#/components/schemas/Advogado' movimentacoes: type: array description: Ate 10 movimentacoes mais recentes (ordenadas por data desc) items: $ref: '#/components/schemas/Movimentacao' Parte: type: object description: >- Parte como retornada pela listagem por CPF/CNPJ. O endpoint GET /processos/numero/{numero} retorna as partes em formato distinto (ver aquele endpoint). properties: nome: type: string description: Nome da parte (Title Case) documento: type: string description: CPF ou CNPJ formatado. String vazia ("") quando ausente. polo: type: string description: 'Polo capitalizado (ex: Ativo, Passivo, Terceiro, Outro)' tipo: type: string description: Tipo da parte enum: - Pessoa Física - Pessoa Jurídica - Autoridade Advogado: type: object description: Advogado como retornado pela listagem por CPF/CNPJ. properties: nome: type: string description: Nome completo do advogado (Title Case) oab: type: string description: 'Numero OAB (ex: SP123456)' polo: type: string description: Polo que representa (capitalizado) documento: type: string description: CPF do advogado formatado. String vazia ("") quando ausente. Movimentacao: type: object properties: data: type: string description: Data ISO (YYYY-MM-DD) descricao: type: string complemento: type: string securitySchemes: tokenAuth: type: apiKey in: query name: token ````