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

# Dívidas federais por CPF

> Retorna dívidas na Dívida Ativa da União, FGTS e Previdenciária vinculadas ao CPF. Inscrições com o mesmo número são agrupadas como histórico.



## OpenAPI

````yaml /openapi/dividas.json get /dividas/cpf/{cpf}
openapi: 3.0.0
info:
  title: Sherlocker Dívidas API
  version: '1.0'
servers:
  - url: https://221b-api.sherlocker.com.br/api/v1
security:
  - bearerAuth: []
paths:
  /dividas/cpf/{cpf}:
    get:
      tags:
        - Dívidas
      summary: Dívidas federais por CPF
      description: >-
        Retorna dívidas na Dívida Ativa da União, FGTS e Previdenciária
        vinculadas ao CPF. Inscrições com o mesmo número são agrupadas como
        histórico.
      operationId: getDividasByCpf
      parameters:
        - name: cpf
          in: path
          required: true
          schema:
            type: string
            example: '12345678901'
      responses:
        '200':
          description: Dívidas encontradas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DividasResponse'
              example:
                documento: '12345678901'
                nome: Fulano De Tal
                total: 2
                valor_total: 21230.5
                ajuizado: true
                dividas:
                  - numero_inscricao: '80000000000001'
                    fonte: ativa_uniao
                    receita: IRPF
                    ajuizado: true
                    data_inscricao: '2019-03-15'
                    valor_atual: 12500
                    uf: SP
                    unidade_responsavel: DRF CAMPINAS
                    historico:
                      - situacao: Ativa
                        valor: 12500
                        data_inscricao: '2019-03-15'
                  - numero_inscricao: '80000000000002'
                    fonte: fgts
                    receita: FGTS
                    ajuizado: false
                    data_inscricao: '2020-06-01'
                    valor_atual: 8730.5
                    uf: SP
                    unidade_responsavel: SRTE/SP
                    entidade_responsavel: CEF
                    historico:
                      - situacao: Ativa
                        valor: 8730.5
                        data_inscricao: '2020-06-01'
        '401':
          description: Token inválido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    DividasResponse:
      type: object
      properties:
        documento:
          type: string
          description: CPF ou CNPJ consultado, apenas digitos (sem formatacao).
        nome:
          type: string
          description: >-
            Nome ou razao social do devedor. String vazia quando o documento nao
            tem dividas.
        total:
          type: integer
        valor_total:
          type: number
        ajuizado:
          type: boolean
        dividas:
          type: array
          items:
            $ref: '#/components/schemas/Divida'
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        error:
          type: string
    Divida:
      type: object
      properties:
        numero_inscricao:
          type: string
        fonte:
          type: string
          enum:
            - ativa_uniao
            - fgts
            - previdenciaria
        receita:
          type: string
          description: Tipo de tributo/receita. String vazia quando ausente na fonte.
        ajuizado:
          type: boolean
        data_inscricao:
          type: string
          format: date
          description: >-
            Data da inscricao mais recente (YYYY-MM-DD). String vazia quando
            ausente na fonte.
        valor_atual:
          type: number
          nullable: true
        uf:
          type: string
          nullable: true
        unidade_responsavel:
          type: string
          description: >-
            Unidade responsavel pela inscricao. String vazia quando ausente na
            fonte.
        entidade_responsavel:
          type: string
          description: Entidade responsavel. Presente apenas quando fonte = "fgts".
        historico:
          type: array
          items:
            $ref: '#/components/schemas/HistoricoItem'
    HistoricoItem:
      type: object
      properties:
        situacao:
          type: string
          description: Situacao da inscricao. String vazia quando ausente na fonte.
        valor:
          type: number
          nullable: true
        data_inscricao:
          type: string
          format: date
          description: >-
            Data da inscricao (YYYY-MM-DD). String vazia quando ausente na
            fonte.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````