Phone Number Intelligence API

Example Request

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"
}'

Example Response

{
  "credits_used": 1,
  "input": "example",
  "normalized_input": "example",
  "kind": "phone_number",
  "valid": true,
  "possible": false,
  "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": false,
    "type": "fixed_line",
    "non_geographic": false
  },
  "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": false,
    "third_party_requests": 0
  },
  "intelligence": {
    "status": "available",
    "kind": "phone_number",
    "reason": "example",
    "coverage": {
      "country": "US",
      "level": "global_numbering_metadata",
      "global_numbering_metadata": false,
      "official_snapshot_available": true,
      "official_allocation_match": false,
      "official_source_ids": [
        "example"
      ],
      "matching_source_ids": [
        "example"
      ],
      "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": false
    },
    "portability": {
      "region_supported": false,
      "current_port_checked": false
    },
    "dialing": {
      "from_country": "US",
      "international": "011 34 612 34 56 78",
      "mobile": "+34 612 34 56 78",
      "internationally_diallable": false
    },
    "number_details": {
      "geographical": false,
      "geographical_area_code": "example",
      "geographical_area_code_length": 1,
      "national_destination_code": "example",
      "national_destination_code_length": 1,
      "subscriber_number_length": 1,
      "mobile_token": "example"
    },
    "service_signals": {
      "number_type": "fixed_line",
      "geographical": false,
      "toll_free": false,
      "premium_rate": false,
      "shared_cost": false,
      "voip": false,
      "personal_number": false,
      "likely_sms_capable": false
    },
    "short_number": {
      "region": "ES",
      "possible": false,
      "valid": true,
      "emergency": false,
      "connects_to_emergency": false,
      "sms_service": false,
      "carrier_specific": false,
      "expected_cost": "toll_free"
    },
    "regulator_allocations": [
      {
        "authority": "CNMC",
        "country": "ES",
        "matched_prefix": "912",
        "matched_range_end": "example",
        "match_kind": "prefix",
        "category": "geographic",
        "status": "assigned",
        "original_assignee": "Example Telecom",
        "operator_code": "example",
        "region": "Madrid",
        "service_description": "example",
        "assigned_on": "2026-08-27",
        "effective_on": "2026-08-27",
        "expires_on": "2026-08-27",
        "current_operator": false,
        "portability_included": false,
        "individual_number_assignment_checked": false,
        "source_id": "cnmc",
        "source_file": "example",
        "details": {}
      }
    ],
    "sources": [
      {
        "id": "google_libphonenumber",
        "name": "Google libphonenumber metadata",
        "type": "offline_metadata",
        "url": "https://example.com",
        "version": "9.0.34",
        "updated_at": "2026-08-27T12:00:00Z",
        "retrieved_at": "2026-08-27T12:00:00Z",
        "age_days": 1,
        "record_count": 1,
        "license": "Apache-2.0",
        "license_url": "https://example.com",
        "attribution": "example"
      }
    ],
    "warnings": [
      "example"
    ],
    "relay": {
      "configured": false,
      "used": false,
      "persisted": false
    }
  },
  "limitations": [
    "example"
  ],
  "metadata": {
    "engine": "libphonenumber-js/max",
    "metadata_basis": "Google libphonenumber numbering plans"
  }
}