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

# Verificar telefones (síncrono)

> Manda até 10 números e recebe o resultado na mesma resposta. Modo `quick` (formato e tipo de linha) ou `full` (inclui WhatsApp).



## OpenAPI

````yaml /es/validations-api/api-reference/openapi-validations.json post /v1/validations/phone
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/phone:
    post:
      tags:
        - Validação de telefone
      summary: Verificar telefones (síncrono)
      description: >-
        Manda até 10 números e recebe o resultado na mesma resposta. Modo
        `quick` (formato e tipo de linha) ou `full` (inclui WhatsApp).
      operationId: ntfVal_verifyPhonesSync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NtfVal_PhoneVerifyRequest'
            examples:
              quick:
                summary: Rápida (formato)
                value:
                  phones:
                    - '+5511999999999'
                    - '+14155552671'
                  mode: quick
              full_whatsapp:
                summary: Completa (com WhatsApp)
                value:
                  phones:
                    - '+5511999999999'
                  mode: full
      responses:
        '200':
          description: Resultado por número na mesma resposta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NtfVal_PhoneVerifyResponse'
              examples:
                full_with_whatsapp:
                  summary: Completa — com WhatsApp
                  value:
                    success: true
                    data:
                      mode: full
                      total_credits_charged: 5
                      results:
                        - phone: '+5511999999999'
                          status: valid
                          phone_valid: true
                          line_type: mobile
                          country_code: BR
                          whatsapp_registered: true
                          reason: null
                          credits_charged: 5
                full_no_whatsapp:
                  summary: Completa — sem WhatsApp
                  value:
                    success: true
                    data:
                      mode: full
                      total_credits_charged: 5
                      results:
                        - phone: '+5511888000000'
                          status: invalid
                          phone_valid: true
                          line_type: fixed_line
                          country_code: BR
                          whatsapp_registered: false
                          reason: WhatsApp not registered
                          credits_charged: 5
                quick:
                  summary: Rápida — whatsapp_registered null
                  value:
                    success: true
                    data:
                      mode: quick
                      total_credits_charged: 2
                      results:
                        - phone: '+5511999999999'
                          status: valid
                          phone_valid: true
                          line_type: mobile
                          country_code: BR
                          whatsapp_registered: null
                          reason: null
                          credits_charged: 1
                        - phone: '+14155552671'
                          status: valid
                          phone_valid: true
                          line_type: mobile
                          country_code: US
                          whatsapp_registered: null
                          reason: null
                          credits_charged: 1
        '402':
          description: Créditos ou saldo insuficiente
components:
  schemas:
    NtfVal_PhoneVerifyRequest:
      type: object
      required:
        - phones
      properties:
        phones:
          type: array
          description: Números a verificar (1 a 10). Aceita E.164 com `+` ou formato local.
          minItems: 1
          maxItems: 10
          items:
            type: string
          example:
            - '+5511999999999'
            - '+14155552671'
        mode:
          $ref: '#/components/schemas/NtfVal_VerifyMode'
    NtfVal_PhoneVerifyResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          type: object
          properties:
            results:
              type: array
              items:
                $ref: '#/components/schemas/NtfVal_PhoneResultItem'
            total_credits_charged:
              type: integer
            mode:
              $ref: '#/components/schemas/NtfVal_VerifyMode'
    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_PhoneResultItem:
      type: object
      description: Resultado da verificação de um número.
      properties:
        phone:
          type: string
          description: Número normalizado em E.164.
          example: '+5511999999999'
        status:
          type: string
          enum:
            - valid
            - invalid
            - unknown
            - risky
          description: >-
            `valid` = utilizável; `invalid` = não usar; `unknown` = não
            concluído.
        phone_valid:
          type: boolean
          description: Passou na checagem de formato internacional.
        line_type:
          type: string
          enum:
            - mobile
            - fixed_line
            - voip
          nullable: true
          description: 'Tipo de linha: celular, fixo ou VoIP.'
        country_code:
          type: string
          nullable: true
          description: 'País ISO (ex.: BR, US).'
          example: BR
        whatsapp_registered:
          type: boolean
          nullable: true
          description: '`null` no modo `quick`. `true`/`false` no modo `full`.'
        reason:
          type: string
          nullable: true
          description: Motivo legível quando falha.
          example: WhatsApp not registered
        credits_charged:
          type: integer
          description: Créditos cobrados nesta verificação.
  securitySchemes:
    ntfValBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    ntfValApiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````