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

# Look up CPF (sync)

> Send up to 10 **CPF + birth date** pairs and get results in the same response. `quick` (local validation) or `full` (official government database). Default: `quick`. Birth date accepts ISO (`1990-01-01`), Brazilian (`01/01/1990`), or compact (`01011990`).



## OpenAPI

````yaml /en/validations-api/api-reference/openapi-validations.json post /v1/validations/cpf
openapi: 3.0.3
info:
  title: Notifique API — Validations (email, phone, and CPF)
  description: >-
    Check emails, phone numbers, and verify CPF before signup or send — like
    filtering your list before a campaign. Authenticate with `Authorization:
    Bearer sk_live_...` or `x-api-key`. Scopes: `validations:email`,
    `validations:phone`, and `validations:cpf` (separate from send channels).
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Produção
security:
  - ntfValBearerAuth: []
  - ntfValApiKeyHeader: []
tags:
  - name: Email validation
    description: Immediate check (up to 10) or async batch (up to 10,000).
  - name: Phone validation
    description: >-
      Immediate check (up to 10) or async batch (500 to 10,000). Includes
      WhatsApp check in `full` mode.
  - name: CPF lookup
    description: >-
      Immediate lookup (up to 10) or async batch (1 to 10,000). `quick` (local)
      or `full` (official government database via partnership).
paths:
  /v1/validations/cpf:
    post:
      tags:
        - CPF lookup
      summary: Look up CPF (sync)
      description: >-
        Send up to 10 **CPF + birth date** pairs and get results in the same
        response. `quick` (local validation) or `full` (official government
        database). Default: `quick`. Birth date accepts ISO (`1990-01-01`),
        Brazilian (`01/01/1990`), or compact (`01011990`).
      operationId: ntfVal_verifyCpfsSync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NtfVal_CpfVerifyRequest'
            examples:
              quick_valid:
                summary: Rápida — válido localmente
                value:
                  items:
                    - cpf: '12345678909'
                      birthDate: '1990-01-01'
                  mode: quick
              full_mixed_dates:
                summary: Completa — dois CPFs
                value:
                  items:
                    - cpf: '12345678909'
                      birthDate: '1990-01-01'
                    - cpf: '98765432100'
                      birthDate: 15/03/1985
                  mode: full
              full_adult_and_minor:
                summary: Full — adult and minor together
                value:
                  items:
                    - cpf: '12345678909'
                      birthDate: '1990-01-01'
                    - cpf: '11144477735'
                      birthDate: '2015-06-10'
                  mode: full
      responses:
        '200':
          description: Per-CPF result in the same response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfVal_CpfVerifyResponse'
              examples:
                quick_valid:
                  summary: Rápida — válido
                  value:
                    success: true
                    data:
                      mode: quick
                      totalCreditsCharged: 1
                      results:
                        - cpf: '12345678909'
                          birthDate: '1990-01-01'
                          status: valid
                          resultCode: 8
                          reason: null
                          name: null
                          socialName: null
                          registrationStatus: null
                          registeredBirthDate: null
                          deceasedIndicator: null
                          creditsCharged: 1
                found:
                  summary: Completa — encontrado
                  value:
                    success: true
                    data:
                      mode: full
                      totalCreditsCharged: 900
                      results:
                        - cpf: '12345678909'
                          birthDate: '1990-01-01'
                          status: found
                          resultCode: 1
                          reason: null
                          name: Maria da Silva
                          socialName: null
                          registrationStatus:
                            code: '0'
                            description: Regular
                          registeredBirthDate: '1990-01-01'
                          deceasedIndicator: null
                          creditsCharged: 900
                not_found:
                  summary: Não encontrado (cobra consulta)
                  value:
                    success: true
                    data:
                      mode: full
                      totalCreditsCharged: 900
                      results:
                        - cpf: '98765432100'
                          birthDate: '1985-03-15'
                          status: notFound
                          resultCode: 2
                          reason: CPF not found.
                          name: null
                          socialName: null
                          registrationStatus: null
                          registeredBirthDate: null
                          deceasedIndicator: null
                          creditsCharged: 900
                minor_blocked:
                  summary: Menor bloqueado (LGPD)
                  value:
                    success: true
                    data:
                      totalCreditsCharged: 900
                      results:
                        - cpf: '11144477735'
                          birthDate: '2015-06-10'
                          status: minorBlocked
                          resultCode: 3
                          reason: Query blocked for minor data protected by LGPD.
                          name: null
                          socialName: null
                          registrationStatus: null
                          registeredBirthDate: null
                          deceasedIndicator: null
                          creditsCharged: 900
                invalid_cpf:
                  summary: CPF inválido (não cobra)
                  value:
                    success: true
                    data:
                      totalCreditsCharged: 0
                      results:
                        - cpf: '00000000000'
                          birthDate: '1990-01-01'
                          status: invalid
                          resultCode: 5
                          reason: Invalid CPF.
                          name: null
                          socialName: null
                          registrationStatus: null
                          registeredBirthDate: null
                          deceasedIndicator: null
                          creditsCharged: 0
                full_adult_and_minor:
                  summary: Full — adult found + minor blocked (LGPD)
                  value:
                    success: true
                    data:
                      mode: full
                      totalCreditsCharged: 1800
                      results:
                        - cpf: '12345678909'
                          birthDate: '1990-01-01'
                          status: found
                          resultCode: 1
                          reason: null
                          name: Maria da Silva
                          socialName: null
                          registrationStatus:
                            code: '0'
                            description: Regular
                          registeredBirthDate: '1990-01-01'
                          deceasedIndicator: null
                          creditsCharged: 900
                        - cpf: '11144477735'
                          birthDate: '2015-06-10'
                          status: minorBlocked
                          resultCode: 3
                          reason: Query blocked for minor data protected by LGPD.
                          name: null
                          socialName: null
                          registrationStatus: null
                          registeredBirthDate: null
                          deceasedIndicator: null
                          creditsCharged: 900
        '402':
          description: Créditos ou saldo insuficiente
components:
  schemas:
    NtfVal_CpfVerifyRequest:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          description: Lista de pares CPF + data de nascimento (1 a 10).
          minItems: 1
          maxItems: 10
          items:
            $ref: '#/components/schemas/NtfVal_CpfItem'
        mode:
          $ref: '#/components/schemas/NtfVal_VerifyMode'
    NtfVal_CpfVerifyResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: object
          properties:
            results:
              type: array
              items:
                $ref: '#/components/schemas/NtfVal_CpfResultItem'
            totalCreditsCharged:
              type: integer
              description: Soma de `creditsCharged` de todos os itens.
            mode:
              $ref: '#/components/schemas/NtfVal_VerifyMode'
    NtfVal_CpfItem:
      type: object
      required:
        - cpf
        - birthDate
      properties:
        cpf:
          type: string
          description: CPF com ou sem pontuação (11 dígitos).
          example: '12345678909'
        birthDate:
          type: string
          description: >-
            Data de nascimento: ISO (`1990-01-01`), brasileiro (`01/01/1990`) ou
            compacto (`01011990`).
          example: '1990-01-01'
    NtfVal_VerifyMode:
      type: string
      enum:
        - quick
        - full
      default: quick
      description: >-
        `quick` = checagens rápidas (formato, MX ou tipo de linha). `full` =
        quick + verificação profunda (caixa de entrada ou WhatsApp).
    NtfVal_CpfResultItem:
      type: object
      description: Resultado da consulta de um CPF.
      properties:
        cpf:
          type: string
          description: CPF normalizado (11 dígitos).
          example: '12345678909'
        birthDate:
          type: string
          format: date
          description: Data de nascimento informada na consulta (ISO).
          example: '1990-01-01'
        status:
          type: string
          enum:
            - valid
            - found
            - notFound
            - minorBlocked
            - invalid
            - error
          description: >-
            `valid` = válido localmente (quick); `found` = encontrado na base
            oficial (full); `notFound`, `minorBlocked`, `invalid`, `error` — ver
            guia.
        resultCode:
          type: integer
          enum:
            - 1
            - 2
            - 3
            - 4
            - 5
            - 6
            - 7
            - 8
          description: >-
            1=encontrado, 2=não encontrado, 3=menor bloqueado, 4=parâmetro
            inválido, 5=CPF inválido, 6=data inválida, 7=erro na consulta,
            8=válido local (quick).
        reason:
          type: string
          nullable: true
          description: Motivo legível quando `status` não é `found`.
          example: CPF not found.
        name:
          type: string
          nullable: true
          description: Nome cadastral (apenas quando `found`).
        socialName:
          type: string
          nullable: true
          description: Nome social, quando existir.
        registrationStatus:
          allOf:
            - $ref: '#/components/schemas/NtfVal_CpfRegistrationStatus'
          nullable: true
        registeredBirthDate:
          type: string
          format: date
          nullable: true
          description: Data de nascimento retornada pela fonte.
        deceasedIndicator:
          type: integer
          nullable: true
          description: Indicador de óbito, quando aplicável.
        creditsCharged:
          type: integer
          description: Créditos cobrados nesta consulta (0 se inválido local ou cache).
    NtfVal_CpfRegistrationStatus:
      type: object
      description: Situação cadastral na base oficial do governo.
      properties:
        code:
          type: string
          example: '0'
        description:
          type: string
          example: Regular
  securitySchemes:
    ntfValBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    ntfValApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````