> ## 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. # Status do lote de CPF ## OpenAPI ````yaml /es/validations-api/api-reference/openapi-validations.json get /v1/validations/cpf/batch/{jobId} 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/{jobId}: get: tags: - Consulta de CPF summary: Status do lote de CPF operationId: ntfVal_getCpfBatch parameters: - name: jobId in: path required: true schema: type: string example: job_cpf_abc123 responses: '200': description: Status e resultados (parciais ou finais) content: application/json: schema: $ref: '#/components/schemas/NtfVal_CpfBatchStatusResponse' examples: completed: summary: Concluído value: success: true data: jobId: job_cpf_abc123 status: completed processed: 2 total: 2 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: '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 errorMessage: null completedAt: '2026-09-04T14:30:00.000Z' createdAt: '2026-09-04T14:00:00.000Z' processing: summary: Em processamento value: success: true data: jobId: job_cpf_abc123 status: processing processed: 150 total: 500 results: null errorMessage: null completedAt: null createdAt: '2026-09-04T14:00:00.000Z' completed_mixed: summary: Lote completado — adulto y menor value: success: true data: jobId: job_cpf_abc123 mode: full status: completed processed: 2 total: 2 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 errorMessage: null completedAt: '2026-09-04T14:30:00.000Z' createdAt: '2026-09-04T14:29:55.000Z' '404': description: Job não encontrado components: schemas: NtfVal_CpfBatchStatusResponse: type: object properties: success: type: boolean data: type: object properties: jobId: type: string mode: $ref: '#/components/schemas/NtfVal_VerifyMode' status: type: string enum: - queued - processing - completed - failed description: Estado do processamento do lote. processed: type: integer description: Itens já processados. total: type: integer description: Total de itens no lote. results: type: array nullable: true description: Resultados parciais ou finais (mesmo schema do síncrono). items: $ref: '#/components/schemas/NtfVal_CpfResultItem' errorMessage: type: string nullable: true description: Mensagem de erro quando `status` é `failed`. completedAt: type: string format: date-time nullable: true createdAt: type: string format: date-time 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 ````