> ## 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.

# Busca processo por numero

> Retorna detalhes completos de um processo judicial pelo numero (com ou sem formatacao), incluindo valores mencionados, tags, eventos, audiencias, mandados, bens, identificadores, portes, partes e advogados. ATENCAO: as partes e advogados deste endpoint divergem da listagem por CPF/CNPJ — aqui `partes[].documento` pode ser null, `polo` vem em minusculas e `partes[].tipo` e o slug bruto (pessoa_fisica / pessoa_juridica). Este endpoint NAO retorna `movimentacoes` (use /processos/numero/{numero}/movimentacoes).



## OpenAPI

````yaml /openapi/processos.json get /processos/numero/{numero}
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/numero/{numero}:
    get:
      tags:
        - Processos
      summary: Busca processo por numero
      description: >-
        Retorna detalhes completos de um processo judicial pelo numero (com ou
        sem formatacao), incluindo valores mencionados, tags, eventos,
        audiencias, mandados, bens, identificadores, portes, partes e advogados.
        ATENCAO: as partes e advogados deste endpoint divergem da listagem por
        CPF/CNPJ — aqui `partes[].documento` pode ser null, `polo` vem em
        minusculas e `partes[].tipo` e o slug bruto (pessoa_fisica /
        pessoa_juridica). Este endpoint NAO retorna `movimentacoes` (use
        /processos/numero/{numero}/movimentacoes).
      operationId: getProcessoByNumero
      parameters:
        - name: numero
          in: path
          required: true
          description: Numero do processo (com ou sem formatacao)
          schema:
            type: string
            example: 0000001-23.2020.8.26.0100
      responses:
        '200':
          description: Detalhes do processo
          content:
            application/json:
              schema:
                type: object
                properties:
                  numero_processo:
                    type: string
                  numero_formatado:
                    type: string
                  tribunal:
                    type: string
                  classe_codigo:
                    type: integer
                  classe_nome:
                    type: string
                  grau:
                    type: string
                  data_ajuizamento:
                    type: string
                    description: Data ISO (YYYY-MM-DD)
                  orgao_julgador:
                    type: string
                  assuntos:
                    type: string
                  valor_acao_num:
                    type: number
                    nullable: true
                    description: >-
                      Maior valor entre o valor declarado e os valores
                      mencionados; null quando ausente
                  valor_acao_formatado:
                    type: string
                    nullable: true
                    description: valor_acao_num formatado em BRL; null quando ausente
                  valores_mencionados:
                    type: array
                    description: Ate 20 valores monetarios mencionados (ordenados desc)
                    items:
                      type: object
                      properties:
                        valor:
                          type: number
                        formatado:
                          type: string
                          description: Valor formatado em BRL
                        tipo:
                          type: string
                          description: Tipo do valor (slug)
                  tags:
                    type: array
                    description: Tags brutas associadas ao processo
                    items:
                      type: string
                  eventos:
                    type: array
                    items:
                      type: object
                      properties:
                        tipo:
                          type: string
                        data:
                          type: string
                          description: Data ISO (YYYY-MM-DD)
                  audiencias:
                    type: array
                    items:
                      type: object
                      properties:
                        tipo:
                          type: string
                        status:
                          type: string
                        data:
                          type: string
                          description: Data ISO (YYYY-MM-DD)
                  mandados:
                    type: array
                    items:
                      type: object
                      properties:
                        tipo:
                          type: string
                        data:
                          type: string
                          description: Data ISO (YYYY-MM-DD)
                  bens:
                    type: array
                    items:
                      type: string
                  identificadores:
                    type: array
                    items:
                      type: object
                      properties:
                        tipo:
                          type: string
                        valor:
                          type: string
                  portes:
                    type: array
                    items:
                      type: string
                  partes:
                    type: array
                    description: >-
                      Formato especifico deste endpoint (diverge da listagem por
                      CPF/CNPJ).
                    items:
                      type: object
                      properties:
                        nome:
                          type: string
                          description: Nome da parte (Title Case)
                        documento:
                          type: string
                          nullable: true
                          description: CPF/CNPJ formatado; null quando ausente
                        polo:
                          type: string
                          description: 'Polo em minusculas (ex: ativo, passivo)'
                        tipo:
                          type: string
                          description: >-
                            Slug bruto do tipo (ex: pessoa_fisica,
                            pessoa_juridica)
                  advogados:
                    type: array
                    items:
                      type: object
                      properties:
                        nome:
                          type: string
                        oab:
                          type: string
                        polo:
                          type: string
                          description: Polo em minusculas
                        documento:
                          type: string
                          description: CPF formatado; string vazia ("") quando ausente
              example:
                numero_processo: '00000012320208260100'
                numero_formatado: 0000001-23.2020.8.26.0100
                tribunal: tjsp
                classe_codigo: 1234
                classe_nome: Procedimento Comum Cível
                grau: G1
                data_ajuizamento: '2020-01-15'
                orgao_julgador: 1ª Vara Cível
                assuntos: Indenização por Dano Moral
                valor_acao_num: 50000
                valor_acao_formatado: R$ 50.000
                valores_mencionados:
                  - valor: 50000
                    formatado: R$ 50.000
                    tipo: causa
                tags:
                  - evento.distribuicao
                  - porte.grande
                eventos:
                  - tipo: distribuicao
                    data: '2020-01-15'
                audiencias: []
                mandados: []
                bens: []
                identificadores: []
                portes:
                  - grande
                partes:
                  - nome: João Silva
                    documento: 123.456.789-01
                    polo: ativo
                    tipo: pessoa_fisica
                  - nome: Empresa X Ltda
                    documento: 12.345.678/0001-99
                    polo: passivo
                    tipo: pessoa_juridica
                advogados:
                  - nome: José Advogado
                    oab: SP123456
                    polo: ativo
                    documento: 987.654.321-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:
    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
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: query
      name: token

````