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

# Detalhe de processo

> Detalhe de um processo judicial pelo numero CNJ, com ou sem pontuacao (20 digitos). Retorna cabecalho, tribunal, classes, assuntos, ate 100 partes e uma pagina de movimentos. Exige o escopo dados:processos. Os movimentos vem da data mais recente para a mais antiga; para a proxima pagina, repita a chamada com `cursor` igual ao `proximo_cursor` recebido (null na ultima).

Cabeçalho, partes e uma página de movimentos de um processo pelo número CNJ. Veja [Detalhe de um processo](https://docs.nlbs.ai/dados/datasets.md#detalhe-de-um-processo).


## OpenAPI

````yaml data-openapi.yaml GET /dados/processos/{numero}
openapi: 3.1.0
info:
  description: API de dados por documento (CPF/CNPJ) e por numero de processo.
  title: NL Labs API de Dados
  version: 0.1.0
servers:
  - url: https://api.nlbs.ai
security: []
paths:
  /dados/processos/{numero}:
    get:
      tags:
        - dados
      summary: Detalhe de processo por numero
      description: >-
        Detalhe de um processo judicial pelo numero CNJ, com ou sem pontuacao
        (20 digitos). Retorna cabecalho, tribunal, classes, assuntos, ate 100
        partes e uma pagina de movimentos. Exige o escopo dados:processos. Os
        movimentos vem da data mais recente para a mais antiga; para a proxima
        pagina, repita a chamada com `cursor` igual ao `proximo_cursor` recebido
        (null na ultima).
      operationId: detalhe_processo_dados_processos__numero__get
      parameters:
        - in: path
          name: numero
          required: true
          schema:
            title: Numero
            type: string
        - description: Cursor opaco da pagina anterior.
          in: query
          name: cursor
          required: false
          schema:
            anyOf:
              - maxLength: 512
                type: string
              - type: 'null'
            description: Cursor opaco da pagina anterior.
            title: Cursor
        - description: Movimentos por pagina.
          in: query
          name: limite
          required: false
          schema:
            default: 20
            description: Movimentos por pagina.
            maximum: 100
            minimum: 1
            title: Limite
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProcessoDetalhe'
          description: Successful Response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Chave invalida
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Escopo insuficiente, sem acesso ou sem empresa
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Processo nao encontrado
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Numero, limite ou cursor invalido
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Cota esgotada
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErroResposta'
          description: Indisponivel
      security:
        - APIKeyHeader: []
components:
  schemas:
    ProcessoDetalhe:
      properties:
        assuntos:
          description: Assuntos do processo na TPU do CNJ.
          items:
            $ref: '#/components/schemas/AssuntoProcesso'
          title: Assuntos
          type: array
        classes:
          description: Todas as classes do processo, a principal primeiro.
          items:
            $ref: '#/components/schemas/ClasseProcesso'
          title: Classes
          type: array
        data_ajuizamento:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Data Ajuizamento
        data_distribuicao:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Data Distribuicao
        grau_atual:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Instancia atual: G1 (primeiro grau), G2 (segundo grau), SUP
            (tribunal superior) ou JE (juizado especial).
          title: Grau Atual
        moeda:
          anyOf:
            - type: string
            - type: 'null'
          title: Moeda
        movimentos:
          description: 'Pagina de movimentos: data desc, sem data por ultimo.'
          items:
            $ref: '#/components/schemas/MovimentoProcesso'
          title: Movimentos
          type: array
        numero:
          description: Numero CNJ formatado (NNNNNNN-DD.AAAA.J.TR.OOOO).
          title: Numero
          type: string
        partes:
          description: Ate 100 partes.
          items:
            $ref: '#/components/schemas/ParteProcesso'
          title: Partes
          type: array
        proximo_cursor:
          anyOf:
            - type: string
            - type: 'null'
          description: Cursor da proxima pagina de movimentos; null quando acabou.
          title: Proximo Cursor
        situacao:
          anyOf:
            - type: string
            - type: 'null'
          title: Situacao
        titulo:
          anyOf:
            - type: string
            - type: 'null'
          title: Titulo
        total_movimentos:
          minimum: 0
          title: Total Movimentos
          type: integer
        total_partes:
          minimum: 0
          title: Total Partes
          type: integer
        tribunal:
          anyOf:
            - $ref: '#/components/schemas/TribunalProcesso'
            - type: 'null'
        ultima_movimentacao:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Ultima Movimentacao
        valor_causa:
          anyOf:
            - type: string
            - type: 'null'
          description: Valor da causa como texto decimal.
          title: Valor Causa
      required:
        - numero
        - titulo
        - classes
        - assuntos
        - tribunal
        - situacao
        - grau_atual
        - data_ajuizamento
        - data_distribuicao
        - ultima_movimentacao
        - valor_causa
        - moeda
        - partes
        - total_partes
        - total_movimentos
        - movimentos
        - proximo_cursor
      title: ProcessoDetalhe
      type: object
    ErroResposta:
      properties:
        erro:
          $ref: '#/components/schemas/ErroDetalhe'
      required:
        - erro
      title: ErroResposta
      type: object
    AssuntoProcesso:
      properties:
        codigo:
          title: Codigo
          type: string
        nome:
          anyOf:
            - type: string
            - type: 'null'
          description: Nome do assunto na TPU do CNJ, quando conhecido.
          title: Nome
      required:
        - codigo
        - nome
      title: AssuntoProcesso
      type: object
    ClasseProcesso:
      properties:
        codigo:
          title: Codigo
          type: string
        nome:
          anyOf:
            - type: string
            - type: 'null'
          description: Nome da classe na TPU do CNJ, quando conhecido.
          title: Nome
      required:
        - codigo
        - nome
      title: ClasseProcesso
      type: object
    MovimentoProcesso:
      properties:
        codigo:
          anyOf:
            - type: string
            - type: 'null'
          title: Codigo
        data:
          anyOf:
            - format: date
              type: string
            - type: 'null'
          title: Data
        nome:
          anyOf:
            - type: string
            - type: 'null'
          title: Nome
        publicado_em:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: ISO 8601 em UTC (sufixo Z).
          title: Publicado Em
        tipo:
          anyOf:
            - type: string
            - type: 'null'
          title: Tipo
      required:
        - codigo
        - nome
        - tipo
        - data
        - publicado_em
      title: MovimentoProcesso
      type: object
    ParteProcesso:
      properties:
        nome:
          anyOf:
            - type: string
            - type: 'null'
          title: Nome
        papel:
          anyOf:
            - type: string
            - type: 'null'
          title: Papel
        papel_detalhe:
          anyOf:
            - type: string
            - type: 'null'
          title: Papel Detalhe
        tipo:
          anyOf:
            - type: string
            - type: 'null'
          description: person ou organization.
          title: Tipo
      required:
        - nome
        - tipo
        - papel
        - papel_detalhe
      title: ParteProcesso
      type: object
    TribunalProcesso:
      properties:
        cidade:
          anyOf:
            - type: string
            - type: 'null'
          title: Cidade
        nome:
          anyOf:
            - type: string
            - type: 'null'
          title: Nome
        uf:
          anyOf:
            - type: string
            - type: 'null'
          title: Uf
      required:
        - nome
        - cidade
        - uf
      title: TribunalProcesso
      type: object
    ErroDetalhe:
      properties:
        codigo:
          title: Codigo
          type: string
        mensagem:
          title: Mensagem
          type: string
      required:
        - codigo
        - mensagem
      title: ErroDetalhe
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.