전화번호 인텔리전스 및 검증

전화번호 인텔리전스 및 검증

전 세계 전화번호를 파싱, 검증, 분류 및 형식화하고, 가능한 경우 오프라인 위치, 시간대, 최초 번호 대역 통신사, 발신, 단축 번호 및 규제 기관 할당 정보를 추가합니다.

오프라인 인텔리전스 필드

intelligence 객체에는 접두 번호 기반 위치와 시간대, 최초 통신사, 발신 안내, 단축 번호 신호 및 일치하는 규제 기관 할당 정보가 포함될 수 있습니다. 통신사나 통신 조회 제공업체에 질의하지 않고 Google libphonenumber와 규제 기관의 공개 스냅샷을 사용합니다.

출처 및 저작자 표시

모든 결과에는 사용된 오프라인 출처가 표시되며, 버전 또는 스냅샷 날짜, 라이선스나 재사용 근거, 출처 URL, 제공된 경우 저작자 표시도 포함됩니다. 현재 공식 번호 할당 스냅샷은 스페인(CNMC), 프랑스(ARCEP), 독일(Bundesnetzagentur), 일본(MIC), 오스트리아(RTR), 노르웨이(Nkom), 폴란드(UKE), 대만(MODA), 미국(NANPA), 캐나다(CNA/CNAC)를 대상으로 합니다. 미국과 캐나다의 근거 자료는 NPA-NXX 중앙국 코드 상태이며, 현재 통신사나 번호 이동성에 대한 실시간 조회 결과가 아닙니다. 기타 국가에는 글로벌 오프라인 번호 체계 메타데이터가 제공되며, coverage.level은 메타데이터와 공식 할당 근거를 구분합니다.

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
}