Inteligencia y validación de números de teléfono

Inteligencia y validación de números de teléfono

Analiza, valida, clasifica y da formato a números de teléfono de todo el mundo, y añade datos sin conexión sobre ubicación, zona horaria, operador original del prefijo, marcación, números cortos y asignaciones del regulador cuando estén disponibles.

Campos de inteligencia sin conexión

El objeto intelligence puede incluir la ubicación y las zonas horarias inferidas del prefijo, el operador original, indicaciones de marcación, señales sobre números cortos y asignaciones coincidentes del regulador. Utiliza Google libphonenumber y copias públicas de datos de reguladores sin consultar a un operador ni a un proveedor de datos de telecomunicaciones.

Fuentes y atribución

Cada resultado enumera las fuentes sin conexión que utilizó, incluida la versión o fecha de la copia, la licencia o base para la reutilización, la URL de la fuente y la atribución, cuando se proporcionan. Las copias oficiales de asignaciones cubren actualmente España (CNMC), Francia (ARCEP), Alemania (Bundesnetzagentur), Japón (MIC), Austria (RTR), Noruega (Nkom), Polonia (UKE), Taiwán (MODA), Estados Unidos (NANPA) y Canadá (CNA/CNAC). Los datos de Estados Unidos y Canadá corresponden al estado de los códigos de central NPA-NXX, no a una consulta en tiempo real del operador ni de portabilidad numérica. Otros países reciben metadatos mundiales de numeración sin conexión, y coverage.level distingue los metadatos de los datos oficiales de asignación.

curl -X POST "https://domscan.net/v1/phone/validate" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "phone": "+34 612 345 678",
  "default_country": "ES",
  "expected_country": "ES",
  "dialing_from_country": "ES",
  "language": "es"
}'

{
  "input": "string",
  "normalized_input": "string",
  "kind": "phone_number",
  "valid": true,
  "possible": true,
  "status": "valid",
  "recommendation": "accept",
  "validation_level": "numbering_plan",
  "reason": "DEFAULT_COUNTRY_REQUIRED",
  "warnings": [
    "COUNTRY_MISMATCH"
  ],
  "number": {
    "e164": "+34612345678",
    "international": "+34 612 34 56 78",
    "national": "612 34 56 78",
    "rfc3966": "tel:+34612345678",
    "national_number": "612345678",
    "extension": null,
    "country": "ES",
    "country_name": "Spain",
    "country_calling_code": "34",
    "possible_countries": [
      "ES"
    ],
    "country_match": true,
    "type": "fixed_line",
    "non_geographic": true
  },
  "live_checks": {
    "assignment": "not_checked",
    "reachability": "not_checked",
    "current_carrier": "not_checked",
    "subscriber_identity": "not_checked",
    "porting": "not_checked"
  },
  "privacy": {
    "upstream_requests": 0,
    "telecom_provider_queried": false,
    "persisted": false,
    "domscan_edge_relay_used": true,
    "third_party_requests": 0
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "reason": "string",
    "coverage": {
      "country": "US",
      "level": "global_numbering_metadata",
      "global_numbering_metadata": true,
      "official_snapshot_available": true,
      "official_allocation_match": true,
      "official_source_ids": [
        "string"
      ],
      "matching_source_ids": [
        "string"
      ],
      "current_carrier_lookup": false
    },
    "location": {
      "label": "Madrid",
      "country_name": "Spain",
      "country": "ES",
      "language": "es",
      "granularity": "numbering_plan_area",
      "current_physical_location": false
    },
    "possible_time_zones": {
      "values": [
        "Europe/Madrid"
      ],
      "current_location": false,
      "inference": "number_prefix"
    },
    "original_prefix_carrier": {
      "name": "Vodafone",
      "source_id": "nanpa_us",
      "evidence": "offline_prefix_metadata",
      "current_carrier": false,
      "portability_may_change_carrier": true
    },
    "portability": {
      "region_supported": true,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "mobile": "+34 612 34 56 78",
      "internationally_diallable": true
    },
    "number_details": {
      "geographical": true,
      "geographical_area_code": "string",
      "geographical_area_code_length": 1,
      "national_destination_code": "string",
      "national_destination_code_length": 1,
      "subscriber_number_length": 1,
      "mobile_token": "string"
    },
    "service_signals": {
      "number_type": "fixed_line",
      "geographical": true,
      "toll_free": true,
      "premium_rate": true,
      "shared_cost": true,
      "voip": "198.51.100.10",
      "personal_number": true,
      "likely_sms_capable": true
    },
    "short_number": {
      "region": "ES",
      "possible": true,
      "valid": true,
      "emergency": true,
      "connects_to_emergency": true,
      "sms_service": true,
      "carrier_specific": true,
      "expected_cost": "toll_free"
    },
    "regulator_allocations": [
      {
        "authority": "CNMC",
        "country": "ES",
        "matched_prefix": "912",
        "matched_range_end": "string",
        "match_kind": "prefix",
        "category": "geographic",
        "status": "assigned",
        "original_assignee": "Example Telecom",
        "operator_code": "string",
        "region": "Madrid",
        "service_description": "198.51.100.10",
        "assigned_on": "2026-04-15",
        "effective_on": "2026-04-15",
        "expires_on": "2026-04-15",
        "current_operator": false,
        "portability_included": false,
        "individual_number_assignment_checked": false,
        "source_id": "cnmc",
        "source_file": "string",
        "details": {}
      }
    ],
    "sources": [
      {
        "id": "google_libphonenumber",
        "name": "Google libphonenumber metadata",
        "type": "offline_metadata",
        "version": "9.0.34",
        "updated_at": "2026-04-15",
        "retrieved_at": "2026-04-15T12:00:00Z",
        "age_days": 1,
        "record_count": 1,
        "license": "Apache-2.0",
        "license_url": "https://example.com",
        "url": "https://example.com",
        "attribution": "string"
      }
    ],
    "warnings": [
      "string"
    ],
    "relay": {
      "configured": true,
      "used": true,
      "persisted": false
    }
  },
  "limitations": [
    "string"
  ],
  "metadata": {
    "engine": "libphonenumber-js/max",
    "metadata_basis": "Google libphonenumber numbering plans"
  },
  "credits_used": 1
}

curl -X POST "https://domscan.net/v1/phone/validate/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "expected_country": "ES",
  "dialing_from_country": "US",
  "language": "en",
  "phones": [
    "+34 612 345 678",
    {
      "phone": "0491 570 006",
      "default_country": "AU",
      "expected_country": "AU",
      "dialing_from_country": "GB",
      "language": "en"
    },
    "+800 1234 5678"
  ]
}'

{
  "total": 1,
  "valid_count": 1,
  "possible_only_count": 1,
  "invalid_count": 1,
  "validation_level": "numbering_plan",
  "results": [
    {
      "input": "string",
      "normalized_input": "string",
      "kind": "phone_number",
      "valid": true,
      "possible": true,
      "status": "valid",
      "recommendation": "accept",
      "validation_level": "numbering_plan",
      "reason": "DEFAULT_COUNTRY_REQUIRED",
      "warnings": [
        "COUNTRY_MISMATCH"
      ],
      "number": {
        "e164": "+34612345678",
        "international": "+34 612 34 56 78",
        "national": "612 34 56 78",
        "rfc3966": "tel:+34612345678",
        "national_number": "612345678",
        "extension": null,
        "country": "ES",
        "country_name": "Spain",
        "country_calling_code": "34",
        "possible_countries": [
          "ES"
        ],
        "country_match": true,
        "type": "fixed_line",
        "non_geographic": true
      },
      "live_checks": {
        "assignment": "not_checked",
        "reachability": "not_checked",
        "current_carrier": "not_checked",
        "subscriber_identity": "not_checked",
        "porting": "not_checked"
      },
      "privacy": {
        "upstream_requests": 0,
        "telecom_provider_queried": false,
        "persisted": false,
        "domscan_edge_relay_used": true,
        "third_party_requests": 0
      },
      "intelligence": {
        "status": "available",
        "kind": "phone_number",
        "reason": "string",
        "coverage": {
          "country": "US",
          "level": "global_numbering_metadata",
          "global_numbering_metadata": true,
          "official_snapshot_available": true,
          "official_allocation_match": true,
          "official_source_ids": [
            "string"
          ],
          "matching_source_ids": [
            "string"
          ],
          "current_carrier_lookup": false
        },
        "location": {
          "label": "Madrid",
          "country_name": "Spain",
          "country": "ES",
          "language": "es",
          "granularity": "numbering_plan_area",
          "current_physical_location": false
        },
        "possible_time_zones": {
          "values": [
            "Europe/Madrid"
          ],
          "current_location": false,
          "inference": "number_prefix"
        },
        "original_prefix_carrier": {
          "name": "Vodafone",
          "source_id": "nanpa_us",
          "evidence": "offline_prefix_metadata",
          "current_carrier": false,
          "portability_may_change_carrier": true
        },
        "portability": {
          "region_supported": true,
          "current_port_checked": false
        },
        "dialing": {
          "from_country": "US",
          "international": "011 34 612 34 56 78",
          "mobile": "+34 612 34 56 78",
          "internationally_diallable": true
        },
        "number_details": {
          "geographical": true,
          "geographical_area_code": "string",
          "geographical_area_code_length": 1,
          "national_destination_code": "string",
          "national_destination_code_length": 1,
          "subscriber_number_length": 1,
          "mobile_token": "string"
        },
        "service_signals": {
          "number_type": "fixed_line",
          "geographical": true,
          "toll_free": true,
          "premium_rate": true,
          "shared_cost": true,
          "voip": "198.51.100.10",
          "personal_number": true,
          "likely_sms_capable": true
        },
        "short_number": {
          "region": "ES",
          "possible": true,
          "valid": true,
          "emergency": true,
          "connects_to_emergency": true,
          "sms_service": true,
          "carrier_specific": true,
          "expected_cost": "toll_free"
        },
        "regulator_allocations": [
          {
            "authority": "CNMC",
            "country": "ES",
            "matched_prefix": "912",
            "matched_range_end": "string",
            "match_kind": "prefix",
            "category": "geographic",
            "status": "assigned",
            "original_assignee": "Example Telecom",
            "operator_code": "string",
            "region": "Madrid",
            "service_description": "198.51.100.10",
            "assigned_on": "2026-04-15",
            "effective_on": "2026-04-15",
            "expires_on": "2026-04-15",
            "current_operator": false,
            "portability_included": false,
            "individual_number_assignment_checked": false,
            "source_id": "cnmc",
            "source_file": "string",
            "details": {}
          }
        ],
        "sources": [
          {
            "id": "google_libphonenumber",
            "name": "Google libphonenumber metadata",
            "type": "offline_metadata",
            "version": "9.0.34",
            "updated_at": "2026-04-15",
            "retrieved_at": "2026-04-15T12:00:00Z",
            "age_days": 1,
            "record_count": 1,
            "license": "Apache-2.0",
            "license_url": "https://example.com",
            "url": "https://example.com",
            "attribution": "string"
          }
        ],
        "warnings": [
          "string"
        ],
        "relay": {
          "configured": true,
          "used": true,
          "persisted": false
        }
      },
      "limitations": [
        "string"
      ],
      "metadata": {
        "engine": "libphonenumber-js/max",
        "metadata_basis": "Google libphonenumber numbering plans"
      }
    }
  ],
  "credits_used": 1
}