Get an FCC ULS license
fcc_spectrum_get_licenseFetch one FCC ULS license or spectrum lease in full by callsign or unique system identifier (USI): licensee (the lessee on a lease), status and key dates, its locations with coordinates, elevation, structure height, and ASR number, each location's antennas, and each antenna's authorized frequencies with power, ERP/EIRP, station class, transmitter, and emission designators; geographic-area licenses list their market and spectrum blocks, and lease links are shown in both directions. Large records are paged: one call lists whole locations up to 50 sites and 100 antennas, up to max_frequencies frequency rows, and 100 leases, and names the location_offset or lease_offset that reads the rest; location_number starts the locations at a location number the search tools return. Technical detail is kept for active, pending-legal, and term-pending records only. A callsign shared by several records returns the active one, else the most recent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| usi | No | Unique system identifier, as digits: the usi field of fcc_spectrum_search_licenses, fcc_spectrum_find_transmitters, or fcc_spectrum_search_frequencies results. Pass this or callsign, not both. | |
| callsign | No | Callsign or lease ID, e.g. "KNKA123" or "L000012345". Case, spaces, and one trailing portable suffix ("/4") are normalized. Pass this or usi, not both. | |
| lease_offset | No | Lease to start at, counted from 0 in lease-ID order; pass nextLeaseOffset from the previous call to read the next 100. | |
| location_number | No | Location number to start at: the locationNumber of a fcc_spectrum_find_transmitters or fcc_spectrum_search_frequencies result. A number the record does not file starts at the next one it does. Pass this or a nonzero location_offset, not both; page on with nextLocationOffset. | |
| location_offset | No | Location to start at, counted from 0 in location-number order; pass nextLocationOffset from the previous call to read the next locations. To start at a location number instead, pass location_number. | |
| max_frequencies | No | Most frequency rows to return across the locations this call lists (1–1000); rows beyond it are dropped from the last locations first. Large microwave and land-mobile licenses exceed the default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The max_frequencies cap applied. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when a record matched; false returns guidance and candidates instead. | |
| shown | No | Frequency rows returned. | |
| notice | No | What this call left out and the call that reads it, where an unfiled location_number started the locations, or why an offset or location number listed nothing. | |
| license | No | The record; present when found is true. | |
| dataAsOf | No | Creation time of the newest applied ULS file (ISO 8601). | |
| guidance | No | Why nothing matched and where to look next; present when found is false. | |
| locations | No | Locations with antennas and frequency rows, one entry per location number (a number filed at several sites lists them in sites): whole locations from location_offset or location_number up to 50 sites and 100 antennas, or one larger location alone; present when found is true. | |
| siteTotal | No | Sites the record files, each site of a shared location number counted; present when found is true. | |
| truncated | No | True when this call leaves part of the record out: locations after the ones listed, frequency rows beyond max_frequencies, or leases after the ones listed. | |
| candidates | No | Up to 5 records whose callsign starts with the one requested; present when a callsign lookup found nothing. | |
| locationTotal | No | Location numbers the record files; present when found is true. | |
| nextLeaseOffset | No | Pass as lease_offset to read the leases after these; absent when none follow. | |
| technicalRetained | No | False when the status is not A, L, or X (active, pending legal, term pending): sites and frequencies are kept only for those, so locations is empty. | |
| nextLocationOffset | No | Pass as location_offset to read the locations after these; absent when none follow. | |
| otherCallsignRecords | No | Other records under the same callsign (ULS reuses callsigns); present when found is true. |