Abstract API Phone Validation Phone Validation API

openapi: 3.2.0
info:
  title: Abstract Phone Validation API
  description: The Abstract API Phone Number Validation & Verification API validates and verifies a phone number in a single request.
  version: '1.0'
  contact:
    name: Abstract API
    url: https://www.abstractapi.com
  x-grounding: Endpoint/method/auth live-probed 2026-07-12 at https://phonevalidation.abstractapi.com/v1/. Response schema modeled from Abstract API docs and official SDK field lists.
servers:
- url: https://phonevalidation.abstractapi.com/v1
  description: Abstract API Phone Validation production host
security:
- apiKeyQuery: []
tags:
- name: Phone Validation
  description: Validate and verify a phone number and return carrier, line type, and location.
paths:
  /:
    get:
      operationId: validatePhone
      tags:
      - Phone Validation
      summary: Validate and verify a phone number
      description: Validates a single phone number and returns validity, local and international formats, country, registered location, line type, and carrier. The number should be supplied in E.164 format (for example +14152007986); an optional country hint can help interpret numbers supplied without a country code.
      parameters:
      - name: api_key
        in: query
        required: true
        description: Your Abstract API Phone Validation API key.
        schema:
          type: string
      - name: phone
        in: query
        required: true
        description: The phone number to validate and verify, ideally in E.164 format (e.g. +14152007986).
        schema:
          type: string
      - name: country
        in: query
        required: false
        description: Optional ISO 3166-1 alpha-2 country code used to interpret a phone number submitted without an international dialing code.
        schema:
          type: string
      responses:
        '200':
          description: Validation and verification result for the submitted phone number.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PhoneValidationResult'
        '204':
          description: No content returned (for example, when the phone parameter is missing).
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: A required parameter is missing or malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit or monthly quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PhoneCountry:
      type: object
      description: The country the phone number is registered to.
      properties:
        code:
          type: string
          description: ISO 3166-1 alpha-2 country code, e.g. US.
        name:
          type: string
          description: Country name, e.g. United States.
        prefix:
          type: string
          description: Country calling code / dialing prefix, e.g. +1.
    PhoneFormat:
      type: object
      description: Local (national) and international representations of the number.
      properties:
        international:
          type: string
          description: The number in international E.164 format, e.g. +14152007986.
        local:
          type: string
          description: The number in national/local format, e.g. (415) 200-7986.
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type:
              - object
              - 'null'
              additionalProperties: true
    PhoneValidationResult:
      type: object
      description: The validation and verification result. Field names and structure follow Abstract API's documented classic phone validation response.
      properties:
        phone:
          type: string
          description: The phone number that was submitted, normalized.
        valid:
          type: boolean
          description: Whether the number is valid.
        format:
          $ref: '#/components/schemas/PhoneFormat'
        country:
          $ref: '#/components/schemas/PhoneCountry'
        location:
          type: string
          description: Registered location (region/state/city) associated with the number.
        type:
          type: string
          description: Line type of the number. Documented values include mobile, landline, voip, toll_free, personal, pager, and unknown.
        carrier:
          type: string
          description: The carrier / telecom provider the number is registered with.
  securitySchemes:
    apiKeyQuery:
      type: apiKey
      in: query
      name: api_key
      description: Abstract API authenticates by an API key passed as the `api_key` query parameter. Each Abstract API product (phone validation, email validation, etc.) has its own distinct key.