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

# Iniciar consulta de CPF em lote

> Mínimo **1** e máximo 10.000 pares CPF + data. Processamento em background — consulte com `GET /v1/validations/cpf/batch/{jobId}`.



## OpenAPI

````yaml /es/validations-api/api-reference/openapi-validations.json post /v1/validations/cpf/batch
openapi: 3.0.3
info:
  title: Notifique API — Validaciones (correo, teléfono y CPF)
  description: >-
    Verifica correos, teléfonos y consulta CPF antes del registro o envío — como
    filtrar la lista antes de una campaña. Autentica con `Authorization: Bearer
    sk_live_...` o `x-api-key`. Ámbitos: `validations:email`,
    `validations:phone` y `validations:cpf` (independientes de los canales de
    envío).
  version: 1.0.0
servers:
  - url: https://api.notifique.dev
    description: Produção
security:
  - ntfValBearerAuth: []
  - ntfValApiKeyHeader: []
tags:
  - name: Validación de correo
    description: Verificación inmediata (hasta 10) o lote asíncrono (hasta 10.000).
  - name: Validación de teléfono
    description: >-
      Verificación inmediata (hasta 10) o lote asíncrono (500 a 10.000). Incluye
      WhatsApp en modo `full`.
  - name: Consulta de CPF
    description: >-
      Consulta inmediata (hasta 10) o lote asíncrono (1 a 10.000). Modo `quick`
      (local) o `full` (base oficial del gobierno vía alianza).
paths:
  /v1/validations/cpf/batch:
    post:
      tags:
        - Consulta de CPF
      summary: Iniciar consulta de CPF em lote
      description: >-
        Mínimo **1** e máximo 10.000 pares CPF + data. Processamento em
        background — consulte com `GET /v1/validations/cpf/batch/{jobId}`.
      operationId: ntfVal_createCpfBatch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NtfVal_CpfBatchCreateRequest'
            examples:
              small_batch:
                summary: Lote pequeno (exemplo com 2 itens)
                value:
                  items:
                    - cpf: '12345678909'
                      birthDate: '1990-01-01'
                    - cpf: '98765432100'
                      birthDate: '1985-03-15'
      responses:
        '200':
          description: Job enfileirado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfVal_CpfBatchCreateResponse'
              examples:
                queued:
                  summary: Enfileirado
                  value:
                    success: true
                    data:
                      jobId: job_cpf_abc123
                      status: queued
                      total: 2
        '402':
          description: Créditos ou saldo insuficiente
components:
  schemas:
    NtfVal_CpfBatchCreateRequest:
      type: object
      required:
        - items
      properties:
        items:
          type: array
          description: Lista de pares CPF + data (1 a 10.000).
          minItems: 1
          maxItems: 10000
          items:
            $ref: '#/components/schemas/NtfVal_CpfItem'
        mode:
          $ref: '#/components/schemas/NtfVal_VerifyMode'
    NtfVal_CpfBatchCreateResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: object
          properties:
            jobId:
              type: string
              description: ID do job — use em `GET .../batch/{jobId}`.
              example: job_cpf_abc123
            status:
              type: string
              enum:
                - queued
              description: Job enfileirado para processamento.
            total:
              type: integer
              description: Quantidade de itens no lote.
            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).
  securitySchemes:
    ntfValBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    ntfValApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````