Search FCC ULS authorizations by frequency
fcc_spectrum_search_frequenciesRead-onlyIdempotent
Find FCC ULS authorizations whose occupied band overlaps a frequency or band. Site assignments (land mobile, microwave, paging, cellular sites) return one row per site and frequency with the site's state and coordinates; market-area licenses and leases (PCS, AWS, 700 MHz, 3.45 and 3.7 GHz, and other auctioned blocks) return one row per spectrum block with its market code and name; 3.5 GHz Priority Access Licenses file no frequency, so list them with fcc_spectrum_search_licenses and radio_service PL. Filter by state, radio service, licensee, FRN, market code, and live status (active by default). For transmitter sites near a coordinate, use fcc_spectrum_find_transmitters.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| frn | No | Licensee's FCC Registration Number, up to 10 digits; spaces and hyphens are removed and it is left-padded with zeros. Individual licensees match and are returned redacted. | |
| kind | No | site: transmitter-site assignments only; market: market-area spectrum blocks only; both (default). | both |
| unit | No | Unit of the frequencies: kHz, MHz (default), or GHz. | MHz |
| limit | No | Rows per page (1–200). | |
| state | No | Two-letter USPS code or full state name. Sites match on their filed state, or the state derived from their coordinates. Market blocks match when their FCC market area reaches the state (a multi-state market matches each of its states), their market name carries the state code, or their license files a site there; nationwide and Gulf of Mexico markets match no state. | |
| cursor | No | nextCursor from the previous page of the same search; omit for the first page. | |
| status | No | A active (default), L pending legal, X term pending, or "any" for all three. Other statuses keep no frequency records. | A |
| licensee | No | Licensee name words, with at least one letter or digit; every word must match the start of a word in the name, in any order. A word joined by - or & ("T-Mobile", "AT&T") matches its pieces side by side. | |
| market_code | No | Market code of the license, matched exactly, e.g. "PEA016", "CMA020", or "NW" (nationwide); market rows carry it as marketCode. Applies to site and market rows alike, since cellular (CMA) licenses file sites rather than blocks. Case, spaces, and hyphens are ignored, and the digits are left-padded with zeros ("pea16" reads as PEA016). | |
| frequency_low | Yes | Frequency in unit; with frequency_high, the band's lower edge. Matches any authorization whose occupied band overlaps. | |
| radio_service | No | Two-character radio service code, e.g. "WU" (700 MHz upper band); see fcc_spectrum_list_reference topic "radio_services". | |
| frequency_high | No | Band upper edge in unit; omit to search a single frequency. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The page limit applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Rows on this page. | |
| notice | No | Why nothing matched, what the state and redaction rules skipped, or how to page further. | |
| dataAsOf | No | Creation time of the newest applied ULS file (ISO 8601). | |
| truncated | No | True when more rows follow this page. | |
| nextCursor | No | Pass as cursor with the same inputs for the next page; absent on the last page. A page over a dense band can hold fewer rows than limit and still carry one. | |
| totalCount | No | Rows matching the filters, across every page; at least this many when totalIsLowerBound is true. | |
| assignments | No | Matching site assignments and market blocks, frequency ascending. | |
| appliedFilters | No | Filters as the server applied them, normalized values and defaults included. | |
| totalIsLowerBound | No | True when a dense band was counted only in part, so totalCount is a lower bound; absent when the count is exact. |