{"openapi":"3.1.0","info":{"title":"UniCRIMINAL API — Execução Penal","version":"2.0.0","description":"Consulta pública de processos de execução penal de todo o Brasil: lista de processos por número, CPF/CNPJ ou nome, e a cópia completa de cada processo (dados gerais, partes com advogados e TODAS as movimentações, com a lista de documentos).\n\nAutenticação: envie sua chave no cabeçalho `x-api-key` (ou `Authorization: Bearer <chave>`, ou `?apikey=`). Crie chaves no painel em /dashboard.\n\nUm sistema UniController · Dev Jackson Tomelin.","contact":{"name":"UniController · Jackson Tomelin"}},"servers":[{"url":"https://www.criminal.carros.app.br"}],"security":[{"chave":[]},{"bearer":[]}],"tags":[{"name":"Consultas"},{"name":"Serviço"}],"paths":{"/processo":{"get":{"tags":["Consultas"],"summary":"Cópia completa do processo (dados, partes e todas as movimentações)","description":"Busca o processo pelo número CNJ e devolve tudo: dados gerais, partes com advogados, todas as movimentações em ordem (mais recente primeiro) e, com `arquivos=1`, a lista de documentos de cada movimento. Com `cpf`, devolve todos os processos da pessoa (até 10 completos).","parameters":[{"name":"numero","in":"query","description":"Número CNJ (com ou sem pontuação)","schema":{"type":"string","example":"8000021-64.2025.8.24.0050"}},{"name":"cpf","in":"query","description":"CPF ou CNPJ (só números) — alternativa ao número","schema":{"type":"string"}},{"name":"arquivos","in":"query","description":"1 = inclui a lista de documentos dos movimentos que têm arquivo","schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Processo(s) completo(s)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaProcesso"}}}},"400":{"description":"Faltou o critério de busca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Chave inválida/revogada ou login exigido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite diário da chave atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"502":{"description":"A base não respondeu agora; tente de novo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}},"post":{"tags":["Consultas"],"summary":"Cópia completa do processo (corpo JSON)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"numeroProcesso":{"type":"string","description":"Número CNJ","example":"8000021-64.2025.8.24.0050"},"cpfCnpj":{"type":"string","description":"CPF/CNPJ (alternativa)"},"arquivos":{"type":"boolean","description":"Inclui lista de documentos"}}}}}},"responses":{"200":{"description":"Processo(s) completo(s)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaProcesso"}}}},"400":{"description":"Faltou o critério de busca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Chave inválida/revogada ou login exigido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite diário da chave atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"502":{"description":"A base não respondeu agora; tente de novo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/consulta":{"get":{"tags":["Consultas"],"summary":"Lista de processos por número, CPF/CNPJ ou nome","parameters":[{"name":"numeroProcesso","in":"query","schema":{"type":"string"}},{"name":"cpfCnpj","in":"query","schema":{"type":"string"}},{"name":"nomeParteReu","in":"query","description":"Nome da pessoa (executado/sentenciado)","schema":{"type":"string"}},{"name":"detalhes","in":"query","description":"1 = já traz a cópia completa de cada processo (campo detalhe)","schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Lista","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaConsulta"}}}},"400":{"description":"Faltou o critério de busca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Chave inválida/revogada ou login exigido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite diário da chave atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"502":{"description":"A base não respondeu agora; tente de novo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}},"post":{"tags":["Consultas"],"summary":"Lista de processos (corpo JSON)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"numeroProcesso":{"type":"string"},"cpfCnpj":{"type":"string"},"nomeParteReu":{"type":"string"},"detalhes":{"type":"boolean"},"arquivos":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Lista","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespostaConsulta"}}}},"400":{"description":"Faltou o critério de busca","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"Chave inválida/revogada ou login exigido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Limite diário da chave atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"502":{"description":"A base não respondeu agora; tente de novo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}},"/status":{"get":{"tags":["Serviço"],"summary":"Situação do serviço","security":[],"responses":{"200":{"description":"OK"}}}},"/health":{"get":{"tags":["Serviço"],"summary":"Health check","security":[],"responses":{"200":{"description":"OK"}}}}},"components":{"securitySchemes":{"chave":{"type":"apiKey","in":"header","name":"x-api-key","description":"Chave criada no painel (/dashboard)"},"bearer":{"type":"http","scheme":"bearer","description":"A mesma chave em Authorization: Bearer"}},"schemas":{"RespostaProcesso":{"type":"object","properties":{"ok":{"type":"boolean"},"total":{"type":"integer"},"processos":{"type":"array","items":{"$ref":"#/components/schemas/Processo"}}}},"RespostaConsulta":{"type":"object","properties":{"ok":{"type":"boolean"},"total":{"type":"integer"},"processos":{"type":"array","items":{"$ref":"#/components/schemas/Processo"}},"motivoVazio":{"type":"string","description":"Quando não há processos"}}},"Processo":{"type":"object","description":"Item da lista. Com detalhes, traz o campo detalhe com a cópia completa.","properties":{"numeroProcesso":{"type":"string","description":"Número CNJ","example":"8000021-64.2025.8.24.0050"},"classe":{"type":"string","description":"Classe processual","example":"Execução da Pena"},"assunto":{"type":"string","description":"Assunto principal","example":"Pena Restritiva de Direitos"},"orgaoJulgador":{"type":"string","description":"Juízo / vara"},"dataAjuizamento":{"type":"string","description":"Distribuição"},"partes":{"type":"string","description":"Partes em uma linha"},"partesDetalhe":{"type":"object","additionalProperties":{"type":"string"},"description":"Partes por papel (lista)"},"executado":{"type":"string","description":"Nome do executado/sentenciado"},"situacao":{"type":"string","description":"Em andamento / Extinto / Arquivado"},"instancia":{"type":"string","description":"Primeira Instância / Segunda Instância"},"detalhe":{"$ref":"#/components/schemas/Detalhe"},"detalheErro":{"type":"string","description":"Quando não foi possível abrir as movimentações agora"}}},"Detalhe":{"type":"object","description":"Cópia completa do processo","properties":{"numeroProcesso":{"type":"string"},"diasEmTramitacao":{"type":"integer","description":"Dias em tramitação","example":486},"classe":{"type":"object","properties":{"codigo":{"type":"string","description":"Código da classe/assunto","example":"386"},"descricao":{"type":"string","description":"Descrição","example":"Execução da Pena"}}},"assunto":{"type":"object","properties":{"codigo":{"type":"string","description":"Código da classe/assunto","example":"386"},"descricao":{"type":"string","description":"Descrição","example":"Execução da Pena"}}},"nivelSigilo":{"type":"string","description":"Público / Segredo de Justiça…"},"comarca":{"type":"string","description":"Comarca/Subseção","example":"TJSC - Pomerode"},"competencia":{"type":"string","description":"Competência","example":"Vara de Execução em Meio Aberto"},"juizo":{"type":"string","description":"Juízo"},"juiz":{"type":"string","description":"Juiz"},"autuacao":{"type":"object","properties":{"texto":{"type":"string","description":"Como aparece no processo","example":"08/07/2025 às 15:30:09"},"data":{"type":"string","description":"AAAA-MM-DD","format":"date","example":"2025-07-08"},"hora":{"type":"string","description":"HH:MM:SS","example":"15:30:09"}}},"distribuicao":{"type":"object","properties":{"texto":{"type":"string","description":"Como aparece no processo","example":"08/07/2025 às 15:30:09"},"data":{"type":"string","description":"AAAA-MM-DD","format":"date","example":"2025-07-08"},"hora":{"type":"string","description":"HH:MM:SS","example":"15:30:09"}}},"extinto":{"type":"boolean","description":"Processo extinto"},"outrasInformacoes":{"type":"object","additionalProperties":{"type":"string"},"description":"Outros campos que o processo mostrar"},"partes":{"type":"array","items":{"$ref":"#/components/schemas/Parte"}},"resumo":{"type":"object","properties":{"totalMovimentos":{"type":"integer"},"primeiroMovimento":{"type":"string"},"ultimoMovimento":{"type":"string"},"comArquivos":{"type":"integer"}}},"movimentos":{"type":"array","description":"Todas as movimentações, da mais recente para a mais antiga","items":{"$ref":"#/components/schemas/Movimento"}}}},"Parte":{"type":"object","properties":{"tipo":{"type":"string","description":"Papel","example":"Executado"},"nome":{"type":"string","description":"Nome","example":"FULANO DE TAL"},"observacoes":{"type":"array","items":{"type":"string"},"example":["Maior que 60 anos (conforme Lei 10.741/2003)"]},"advogados":{"type":"array","items":{"type":"object","properties":{"oab":{"type":"string","description":"OAB com UF","example":"12345N-SC"},"nome":{"type":"string"}}}},"semAdvogado":{"type":"boolean"}}},"Movimento":{"type":"object","properties":{"seq":{"type":"integer","description":"Sequência do evento","example":54},"dataHora":{"type":"string","description":"DD/MM/AAAA HH:MM:SS","example":"03/08/2026 15:24:45"},"data":{"type":"string","description":"AAAA-MM-DD","format":"date"},"hora":{"type":"string"},"evento":{"type":"string","description":"Evento","example":"OUTRAS DECISÕES"},"descricao":{"type":"string","description":"Complemento do evento"},"movimentadoPor":{"type":"string","description":"Quem movimentou (nomes de servidores vêm mascarados)","example":"W***********"},"perfil":{"type":"string","description":"Perfil de quem movimentou","example":"Magistrado(a)"},"origem":{"type":"string","description":"Código da origem","enum":["JUIZ","SERVIDOR","PROMOTOR","ADVOGADO","DEFENSOR","PROCURADOR","OFICIALJUSTICA","AUDIENCIA","OUTROS"]},"origemDescricao":{"type":"string","description":"Origem por extenso","example":"Magistrado"},"grau":{"type":"integer","description":"1 ou 2"},"referenciaSeq":{"type":"array","items":{"type":"integer"},"description":"Eventos citados (seq.)"},"habilitacaoProvisoria":{"type":"boolean"},"temArquivos":{"type":"boolean","description":"O movimento tem documento"},"arquivos":{"type":"array","items":{"type":"object","properties":{"nome":{"type":"string"},"link":{"type":"string"}}}},"links":{"type":"array","items":{"type":"object","properties":{"texto":{"type":"string"},"href":{"type":"string"}}}}}},"Erro":{"type":"object","properties":{"ok":{"type":"boolean","example":false},"erro":{"type":"string"}}}}}}