{ "catalog": "NumberResearch.org datasets", "updated_at": "2026-09-18T18:19:28+00:00", "datasets": [ { "id": "area-code-registry", "title": "North American Area Code Registry", "description": "Every NANP area code (NPA) with status, jurisdiction, in-service date, parent/overlay relationships and relief-planning flag.", "coverage": "United States, Canada, and NANP Caribbean member territories", "access": "free", "license": "CC BY 4.0", "source_org": "NANPA (NPA database) + CNAC", "source_url": "https://nanpa.com/reports/npa-reports", "row_count": 800, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "npa": "3-digit area code", "kind": "geographic | non_geographic | toll_free | personal | ...", "status": "in_service | planned | reserved | retired | suspended", "country": "US | CANADA | Caribbean nation", "in_service_date": "date the NPA entered service", "parent_npa": "NPA this was split from, if any" }, "limitations": "Country is stored as a full name (e.g. CANADA). Non-geographic and toll-free codes have no prefix-level statistics.", "landing_page": "https://www.numberresearch.org/datasets/area-code-registry", "formats": [ "csv", "json" ] }, { "id": "numbering-events", "title": "Numbering Change Events (Relief, Overlays & Splits)", "description": "Relief decisions, overlays, splits and jeopardy declarations consolidated from NANPA planning letters, with permissive/mandatory dialing dates extracted verbatim.", "coverage": "US and Canada, 1996\u2013present", "access": "free", "license": "CC BY 4.0", "source_org": "NANPA planning letters", "source_url": "https://nanpa.com/npa-relief/planning-letters", "row_count": 271, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "slug": "stable event identifier", "event_type": "overlay | split | new_npa | jeopardy | other", "npa": "primary NPA", "related_npa": "new/overlay NPA where applicable", "permissive_start": "permissive dialing start date", "mandatory_date": "mandatory dialing date", "effective_date": "new code activation date" }, "limitations": "Dialing dates are present only where the planning letter states them verbatim (quote-verified). Some older planning letters are scanned images without a text layer and are not yet parsed.", "landing_page": "https://www.numberresearch.org/datasets/numbering-events", "formats": [ "csv", "json" ] }, { "id": "prefix-assignments", "title": "NPA-NXX Prefix Assignments", "description": "Central-office (NPA-NXX) prefix assignments with initial assignee, OCN and rate center from the daily NANPA CO code file.", "coverage": "United States and Canada", "access": "individual", "license": "Members \u2014 internal use, no redistribution", "source_org": "NANPA CO Code Assignment file + CNAC", "source_url": "https://nanpa.com/reports/co-code-reports", "row_count": 233683, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "npa": "area code", "nxx": "prefix", "assignee_name": "initial assignee (NOT current serving carrier \u2014 numbers may be ported)", "ocn": "operating company number", "rate_center": "rate center", "assigned_date": "assignment date", "status": "assigned | assigned_pending" }, "limitations": "Initial-assignee records. Because of number portability they do not identify the current serving carrier of any individual number.", "landing_page": "https://www.numberresearch.org/datasets/prefix-assignments", "formats": [ "csv", "json", "xlsx" ] }, { "id": "utilization", "title": "NPA Prefix-Assignment Utilization", "description": "Per-NPA count of assigned prefixes and approximate prefix-assignment utilization (assigned \u00f7 ~792 assignable NXX).", "coverage": "United States", "access": "professional", "license": "Members \u2014 internal use", "source_org": "NANPA CO Code Assignment file", "source_url": "https://nanpa.com/reports/co-code-reports", "row_count": 233683, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "npa": "area code", "assigned_prefixes": "count of assigned NXX", "approx_utilization_pct": "assigned \u00f7 ~792 assignable NXX" }, "limitations": "This is prefix-assignment utilization, NOT the share of individual phone numbers in use. Thousands-block pooling and number-level utilization are separate concepts. Counts can exceed the ~792 denominator because the CO code file includes some service/special codes.", "landing_page": "https://www.numberresearch.org/datasets/utilization", "formats": [ "csv", "json" ] }, { "id": "carrier-footprint", "title": "Initial-Assignment Carrier Footprint", "description": "Aggregated initial-assignment records by legal assignee \u2014 allocation footprint, not current subscriber market share.", "coverage": "United States", "access": "professional", "license": "Members \u2014 internal use", "source_org": "NANPA CO Code Assignment file", "source_url": "https://nanpa.com/reports/co-code-reports", "row_count": 233683, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "assignee_name": "legal initial assignee", "prefixes": "assigned prefix count", "states": "jurisdictions", "rate_centers": "rate center count" }, "limitations": "Allocation-based (initial assignees). This is NOT current-carrier market share or subscriber counts. Number portability means served customers differ from initial allocations.", "landing_page": "https://www.numberresearch.org/datasets/carrier-footprint", "formats": [ "csv", "json" ] }, { "id": "change-events", "title": "Numbering Change-Event Feed (Bitemporal Ledger)", "description": "Field-level changes observed between consecutive official files, recorded bitemporally: when we observed it vs the official file date vs the effective date.", "coverage": "US and Canada, from 2026-09-18 onward", "access": "professional", "license": "Members \u2014 internal use", "source_org": "Derived from NANPA/CNAC daily files", "source_url": "https://numberresearch.org/methodology", "row_count": 28733, "latest_version": "2026-09-18", "source_date": "2026-04", "columns": { "entity": "nxx | block", "npa": "area code", "nxx": "prefix", "block": "thousands-block", "change_kind": "observed_added | observed_removed | field_changed", "field": "changed field", "old_value": "previous", "new_value": "current", "observed_at": "when we saw it", "source_published_at": "official file date", "effective_date": "official effective date" }, "limitations": "The ledger began on 2026-09-18; nothing before that is reconstructed. Initial-assignee semantics apply.", "landing_page": "https://www.numberresearch.org/datasets/change-events", "formats": [ "csv", "json" ] } ] }