> ## 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 e-mails



## OpenAPI

````yaml /es/validations-api/api-reference/openapi-validations.json get /v1/validations/email/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/email/batch/{jobId}:
    get:
      tags:
        - Validação de e-mail
      summary: Status do lote de e-mails
      operationId: ntfVal_getEmailBatch
      parameters:
        - name: jobId
          in: path
          required: true
          schema:
            type: string
          example: job_email_abc123
      responses:
        '200':
          description: Status e resultados (parciais ou finais)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfVal_EmailBatchStatusResponse'
              examples:
                processing:
                  summary: Em processamento
                  value:
                    success: true
                    data:
                      job_id: job_email_abc123
                      status: processing
                      mode: full
                      processed: 1500
                      total: 3000
                      results: []
                      error_message: null
                      completed_at: null
                      created_at: '2026-09-02T10:00:00.000Z'
                completed:
                  summary: Concluído
                  value:
                    success: true
                    data:
                      job_id: job_email_abc123
                      status: completed
                      mode: full
                      processed: 3
                      total: 3
                      results:
                        - email: lead1@empresa.com
                          status: valid
                          reason: null
                          disposable: false
                          mx_found: true
                          catch_all: false
                          suggested_spelling: null
                          credits_charged: 5
                        - email: bounce@dominio-invalido.xyz
                          status: invalid
                          reason: MX record not found
                          disposable: false
                          mx_found: false
                          catch_all: null
                          suggested_spelling: null
                          credits_charged: 0
                      error_message: null
                      completed_at: '2026-09-02T10:05:00.000Z'
                      created_at: '2026-09-02T10:00:00.000Z'
        '404':
          description: Job não encontrado
components:
  schemas:
    NtfVal_EmailBatchStatusResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            job_id:
              type: string
            status:
              type: string
              enum:
                - queued
                - processing
                - completed
                - failed
              description: Estado do processamento do lote.
            mode:
              $ref: '#/components/schemas/NtfVal_VerifyMode'
            processed:
              type: integer
              description: Itens já processados.
            total:
              type: integer
              description: Total de itens no lote.
            results:
              type: array
              description: Resultados parciais ou finais (mesmo schema do síncrono).
              items:
                $ref: '#/components/schemas/NtfVal_EmailResultItem'
            error_message:
              type: string
              nullable: true
              description: Mensagem de erro quando `status` é `failed`.
            completed_at:
              type: string
              format: date-time
              nullable: true
            created_at:
              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_EmailResultItem:
      type: object
      description: Resultado da verificação de um e-mail.
      properties:
        email:
          type: string
          example: cliente@example.com
        status:
          type: string
          enum:
            - valid
            - invalid
            - unknown
            - risky
          description: >-
            `valid` = entregável; `invalid` = não usar; `risky` = arriscado;
            `unknown` = não concluído.
        reason:
          type: string
          nullable: true
          description: Motivo legível quando `status` não é `valid`.
          example: MX record not found
        disposable:
          type: boolean
          description: 'E-mail temporário/descartável (ex.: serviços de 10 minutos).'
        mx_found:
          type: boolean
          description: O domínio tem registro MX (aceita receber e-mail).
        catch_all:
          type: boolean
          nullable: true
          description: Domínio catch-all (aceita qualquer usuário — menor confiança).
        suggested_spelling:
          type: string
          nullable: true
          description: 'Correção sugerida quando há typo comum (ex.: gmail.com).'
        credits_charged:
          type: integer
          description: >-
            Créditos cobrados nesta verificação (0 se formato inválido ou
            cache).
  securitySchemes:
    ntfValBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    ntfValApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````