> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Radio Licenses

> Active company radio licences across six FCC business services

Finds a company’s active FCC radio licences by FRN, call sign or exact legal name. Returns call signs, services, status, dates and business licensee details.

For example, “Which paging licences does AMS Spectrum Holdings hold?” or “Find spectrum licences for a company’s radio fleet.” `company_contractor_license` covers trade credentials.

Covers active company licences in private and commercial land mobile, microwave, market-based spectrum, cellular and paging services, from weekly complete files. Individual licensees, records with no company name and malformed records are excluded.

Exactly one of `frn`, `call_sign` and `licensee_name` is required. Optional `service`, `expiring_before`, `limit` and `offset` narrow or page the results. Invalid inputs and unavailable datasets are refused before payment. A call does not contact the source.

## Input

* `frn`: FCC Registration Number, exactly ten digits; supply exactly one identifier
* `call_sign`: FCC call sign; supply exactly one identifier
* `licensee_name`: Exact legal name after case, punctuation and legal suffix folding; supply exactly one identifier
* `service`: Weekly service file to search; omit to check all six
* `expiring_before`: Expiration strictly before this real YYYY-MM-DD date
* `limit`: Page size, default 50
* `offset`: Results to skip, default 0

## Result

`licenses` contains active company licences ordered by call sign. `total` counts matches before pagination. Only the six listed services are covered. An empty result says nothing about other services or expired licences.

`as_of` and `services_checked[].as_of` are the weekly releases’ own dates; `retrieved_at` records acquisition. Missing, failed, overdue or disabled relevant data returns 503 before payment.

```typescript theme={null}
const result = await agent.tool('lookup/company-radio-licenses', { frn: '0019131390', service: 'paging' });
```

```json theme={null}
{
  "success": true,
  "data": {
    "licenses": [
      {
        "call_sign": "KAA888",
        "radio_service_code": "CD",
        "radio_service_name": "Paging and Radiotelephone",
        "service": "paging",
        "status": "A",
        "grant_date": "2019-08-27",
        "expiration_date": "2029-07-29",
        "effective_date": "2026-07-16",
        "last_action_date": "2026-07-16",
        "licensee_name": "AMS Spectrum Holdings, LLC",
        "licensee_key": "AMS SPECTRUM HOLDINGS",
        "frn": "0019131390",
        "applicant_type": "L",
        "licensee_city": "Lewisville",
        "licensee_state": "TX"
      }
    ],
    "total": 228,
    "limit": 50,
    "offset": 0,
    "source": "Federal Communications Commission",
    "services_checked": [
      {
        "service": "paging",
        "as_of": "2026-11-01T15:20:31.000Z",
        "retrieved_at": "2026-11-03T04:12:39.000Z"
      }
    ],
    "as_of": "2026-11-01T15:20:31.000Z",
    "retrieved_at": "2026-11-03T04:12:39.000Z",
    "coverage": "Active company FCC licences in private and commercial land mobile, microwave, market-based spectrum, cellular and paging services, loaded from weekly complete files. Individual licensees are excluded. Records with no company name and malformed records are also excluded.",
    "absence": null
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.