The API, in detail.
Base URL: https://api.fccidapi.com
Send Authorization: Bearer YOUR_API_KEY on all data requests. Health checks are public. REST accepts API keys; OAuth access tokens are scoped toMCP.
Generated from the same Rust OpenAPI definitions as the service. The live specification describes the deployed version.
No endpoints match. Try “search” or “exhibits”.
/health/live
No query parameters.
Responses
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/health/ready
No query parameters.
Responses
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/applications/{id}
| Parameter | Type / location | Description |
|---|---|---|
idRequired | string path | See schema for accepted values. |
Responses
404 · Application not collected
No response body.
409 · Source detail requires review
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/brand
| Parameter | Type / location | Description |
|---|---|---|
brandOptional | string query | See schema for accepted values. |
qOptional | string query | See schema for accepted values. |
grantee_codeOptional | string query | See schema for accepted values. |
Responses
200 · Response schema
application/json · object
{}400 · brand, q or grantee_code required
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/bulk
No query parameters.
Responses
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/coverage
No query parameters.
Responses
200 · Local corpus counts and recent import receipts; no completeness claim
application/json · object
{}Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/exhibits/search
| Parameter | Type / location | Description |
|---|---|---|
qOptional | string query | See schema for accepted values. |
fccidOptional | string query | See schema for accepted values. |
exhibit_typeOptional | string query | See schema for accepted values. |
storedOptional | boolean query | See schema for accepted values. |
cursorOptional | string query | See schema for accepted values. |
limitOptional | integer query | See schema for accepted values. |
Responses
200 · Response schema
application/json · object
{}Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/exhibits/{id}
| Parameter | Type / location | Description |
|---|---|---|
idRequired | string path | See schema for accepted values. |
Responses
200 · Response schema
application/json · object
{}404 · Not in collected metadata
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/fccid/{id}
| Parameter | Type / location | Description |
|---|---|---|
idRequired | string path | FCC ID |
fccidOptional | string query | Exact FCC ID; punctuation is preserved. |
qOptional | string query | Substring of FCC ID, applicant name or collected product description. |
granteeOptional | string query | See schema for accepted values. |
countryOptional | string query | See schema for accepted values. |
equipment_classOptional | string query | See schema for accepted values. |
grant_statusOptional | string query | EAS observation: granted, not_granted or unknown; not a compliance verdict. |
has_detailsOptional | boolean query | Restrict to applications with (or without) collected detail pages. |
needs_refreshOptional | boolean query | Missing details, an older projection, source change, or scheduled refresh due. |
refresh_priorityOptional | boolean query | Queue-only priority ordering; incompatible with cursor pagination. |
from_dateOptional | string query | See schema for accepted values. |
to_dateOptional | string query | See schema for accepted values. |
lower_mhzOptional | number query | Frequency overlap in MHz; both bounds required. |
upper_mhzOptional | number query | See schema for accepted values. |
cursorOptional | string query | Last application source ID from next_cursor. URL-encode it as a query value. |
limitOptional | integer query | Default 25, maximum 100 applications. |
Responses
404 · Not in the local corpus; not an FCC invalidity verdict
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/fccid/{id}/exhibits
| Parameter | Type / location | Description |
|---|---|---|
idRequired | string path | See schema for accepted values. |
fccidOptional | string query | Exact FCC ID; punctuation is preserved. |
qOptional | string query | Substring of FCC ID, applicant name or collected product description. |
granteeOptional | string query | See schema for accepted values. |
countryOptional | string query | See schema for accepted values. |
equipment_classOptional | string query | See schema for accepted values. |
grant_statusOptional | string query | EAS observation: granted, not_granted or unknown; not a compliance verdict. |
has_detailsOptional | boolean query | Restrict to applications with (or without) collected detail pages. |
needs_refreshOptional | boolean query | Missing details, an older projection, source change, or scheduled refresh due. |
refresh_priorityOptional | boolean query | Queue-only priority ordering; incompatible with cursor pagination. |
from_dateOptional | string query | See schema for accepted values. |
to_dateOptional | string query | See schema for accepted values. |
lower_mhzOptional | number query | Frequency overlap in MHz; both bounds required. |
upper_mhzOptional | number query | See schema for accepted values. |
cursorOptional | string query | Last application source ID from next_cursor. URL-encode it as a query value. |
limitOptional | integer query | Default 25, maximum 100 applications. |
Responses
200 · Exhibit lists grouped by application with explicit collection status
application/json · object
{}Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/frequency
| Parameter | Type / location | Description |
|---|---|---|
fccidOptional | string query | Exact FCC ID; punctuation is preserved. |
qOptional | string query | Substring of FCC ID, applicant name or collected product description. |
granteeOptional | string query | See schema for accepted values. |
countryOptional | string query | See schema for accepted values. |
equipment_classOptional | string query | See schema for accepted values. |
grant_statusOptional | string query | EAS observation: granted, not_granted or unknown; not a compliance verdict. |
has_detailsOptional | boolean query | Restrict to applications with (or without) collected detail pages. |
needs_refreshOptional | boolean query | Missing details, an older projection, source change, or scheduled refresh due. |
refresh_priorityOptional | boolean query | Queue-only priority ordering; incompatible with cursor pagination. |
from_dateOptional | string query | See schema for accepted values. |
to_dateOptional | string query | See schema for accepted values. |
lower_mhzOptional | number query | Frequency overlap in MHz; both bounds required. |
upper_mhzOptional | number query | See schema for accepted values. |
cursorOptional | string query | Last application source ID from next_cursor. URL-encode it as a query value. |
limitOptional | integer query | Default 25, maximum 100 applications. |
Responses
200 · Response schema
application/json · object
{}400 · FCC ID or frequency bounds required
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/grantees
| Parameter | Type / location | Description |
|---|---|---|
qOptional | string query | See schema for accepted values. |
cursorOptional | string query | See schema for accepted values. |
limitOptional | integer query | See schema for accepted values. |
Responses
200 · Historical registry with keyset pagination
application/json · object
{}Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/grantees/{code}
| Parameter | Type / location | Description |
|---|---|---|
codeRequired | string path | See schema for accepted values. |
fccidOptional | string query | Exact FCC ID; punctuation is preserved. |
qOptional | string query | Substring of FCC ID, applicant name or collected product description. |
granteeOptional | string query | See schema for accepted values. |
countryOptional | string query | See schema for accepted values. |
equipment_classOptional | string query | See schema for accepted values. |
grant_statusOptional | string query | EAS observation: granted, not_granted or unknown; not a compliance verdict. |
has_detailsOptional | boolean query | Restrict to applications with (or without) collected detail pages. |
needs_refreshOptional | boolean query | Missing details, an older projection, source change, or scheduled refresh due. |
refresh_priorityOptional | boolean query | Queue-only priority ordering; incompatible with cursor pagination. |
from_dateOptional | string query | See schema for accepted values. |
to_dateOptional | string query | See schema for accepted values. |
lower_mhzOptional | number query | Frequency overlap in MHz; both bounds required. |
upper_mhzOptional | number query | See schema for accepted values. |
cursorOptional | string query | Last application source ID from next_cursor. URL-encode it as a query value. |
limitOptional | integer query | Default 25, maximum 100 applications. |
Responses
200 · Historical registry plus collected applications
application/json · object
{}Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/lookup
| Parameter | Type / location | Description |
|---|---|---|
fccidOptional | string query | See schema for accepted values. |
qOptional | string query | See schema for accepted values. |
brandOptional | string query | See schema for accepted values. |
manufacturerOptional | string query | See schema for accepted values. |
modelOptional | string query | See schema for accepted values. |
limitOptional | integer query | See schema for accepted values. |
Responses
200 · Response schema
application/json · object
{}400 · Invalid matching query
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/search
| Parameter | Type / location | Description |
|---|---|---|
fccidOptional | string query | Exact FCC ID; punctuation is preserved. |
qOptional | string query | Substring of FCC ID, applicant name or collected product description. |
granteeOptional | string query | See schema for accepted values. |
countryOptional | string query | See schema for accepted values. |
equipment_classOptional | string query | See schema for accepted values. |
grant_statusOptional | string query | EAS observation: granted, not_granted or unknown; not a compliance verdict. |
has_detailsOptional | boolean query | Restrict to applications with (or without) collected detail pages. |
needs_refreshOptional | boolean query | Missing details, an older projection, source change, or scheduled refresh due. |
refresh_priorityOptional | boolean query | Queue-only priority ordering; incompatible with cursor pagination. |
from_dateOptional | string query | See schema for accepted values. |
to_dateOptional | string query | See schema for accepted values. |
lower_mhzOptional | number query | Frequency overlap in MHz; both bounds required. |
upper_mhzOptional | number query | See schema for accepted values. |
cursorOptional | string query | Last application source ID from next_cursor. URL-encode it as a query value. |
limitOptional | integer query | Default 25, maximum 100 applications. |
Responses
400 · Invalid filter
No response body.
503 · Database unavailable
No response body.
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
/v1/validate
| Parameter | Type / location | Description |
|---|---|---|
fccidRequired | string query | See schema for accepted values. |
Responses
Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →
Data schemas
Optional fields may be absent. Nullable fields may be null. Preserve missing values; do not turn them into inferred facts.
Application
| Field | Type | Meaning |
|---|---|---|
action_dateRequired | string | — |
applicant_nameOptional | string | null | — |
countryOptional | string | null | — |
detailsOptional | object | — |
evidenceRequired | array<Evidence> | — |
exhibits_urlRequired | string | — |
fcc_idRequired | string | — |
form_urlRequired | string | — |
frequenciesRequired | array<Frequency> | — |
grant_statusRequired | string | — |
grant_urlOptional | string | null | — |
grantee_codeRequired | string | — |
product_codeRequired | string | — |
profileRequired | Profile | — |
purposeOptional | string | null | — |
source_idRequired | string | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"action_date": {
"format": "date",
"type": "string"
},
"applicant_name": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"details": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/components/schemas/Details",
"description": "None means not collected; Some with zero exhibits means a fetched empty public list."
}
]
},
"evidence": {
"items": {
"$ref": "#/components/schemas/Evidence"
},
"type": "array"
},
"exhibits_url": {
"type": "string"
},
"fcc_id": {
"type": "string"
},
"form_url": {
"type": "string"
},
"frequencies": {
"items": {
"$ref": "#/components/schemas/Frequency"
},
"type": "array"
},
"grant_status": {
"type": "string"
},
"grant_url": {
"type": [
"string",
"null"
]
},
"grantee_code": {
"type": "string"
},
"product_code": {
"type": "string"
},
"profile": {
"$ref": "#/components/schemas/Profile"
},
"purpose": {
"type": [
"string",
"null"
]
},
"source_id": {
"type": "string"
}
},
"required": [
"source_id",
"fcc_id",
"grantee_code",
"product_code",
"action_date",
"grant_status",
"profile",
"form_url",
"exhibits_url",
"frequencies",
"evidence"
],
"type": "object"
}BulkApplication
| Field | Type | Meaning |
|---|---|---|
action_dateRequired | string | — |
applicant_nameOptional | string | null | — |
countryOptional | string | null | — |
equipment_classOptional | string | null | — |
fcc_idRequired | string | — |
grant_statusRequired | string | — |
has_detailsRequired | boolean | — |
held_for_reviewRequired | boolean | — |
source_idRequired | string | — |
source_urlOptional | string | null | — |
Raw JSON schema
{
"properties": {
"action_date": {
"format": "date",
"type": "string"
},
"applicant_name": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"equipment_class": {
"type": [
"string",
"null"
]
},
"fcc_id": {
"type": "string"
},
"grant_status": {
"type": "string"
},
"has_details": {
"type": "boolean"
},
"held_for_review": {
"type": "boolean"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"source_id",
"fcc_id",
"action_date",
"grant_status",
"has_details",
"held_for_review"
],
"type": "object"
}BulkInput
| Field | Type | Meaning |
|---|---|---|
fcc_idsRequired | array<string> | 1–5 distinct IDs on Free, 1–100 on paid plans. Each ID costs one API unit. |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"fcc_ids": {
"description": "1–5 distinct IDs on Free, 1–100 on paid plans. Each ID costs one API unit.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"fcc_ids"
],
"type": "object"
}BulkMatch
| Field | Type | Meaning |
|---|---|---|
applicationsRequired | array<BulkApplication> | — |
fcc_idRequired | string | — |
statusRequired | string | found or not_in_collected_corpus; never an FCC validity determination. |
truncatedRequired | boolean | At most ten recent applications per ID. Follow /v1/search?fccid=... for more. |
Raw JSON schema
{
"properties": {
"applications": {
"items": {
"$ref": "#/components/schemas/BulkApplication"
},
"type": "array"
},
"fcc_id": {
"type": "string"
},
"status": {
"description": "found or not_in_collected_corpus; never an FCC validity determination.",
"type": "string"
},
"truncated": {
"description": "At most ten recent applications per ID. Follow /v1/search?fccid=... for more.",
"type": "boolean"
}
},
"required": [
"fcc_id",
"status",
"applications",
"truncated"
],
"type": "object"
}BulkOutput
| Field | Type | Meaning |
|---|---|---|
corpus_scopeRequired | string | — |
csvOptional | string | null | — |
resultsRequired | array<BulkMatch> | — |
unitsRequired | integer | — |
Raw JSON schema
{
"properties": {
"corpus_scope": {
"type": "string"
},
"csv": {
"type": [
"string",
"null"
]
},
"results": {
"items": {
"$ref": "#/components/schemas/BulkMatch"
},
"type": "array"
},
"units": {
"format": "int32",
"type": "integer"
}
},
"required": [
"results",
"units",
"corpus_scope"
],
"type": "object"
}DetailFailure
| Field | Type | Meaning |
|---|---|---|
attempted_atRequired | string | — |
http_statusRequired | integer | — |
prior_receipt_sha256Required | string | — |
reasonRequired | string | — |
receipt_sha256Required | string | — |
review_requiredRequired | boolean | — |
schema_versionRequired | integer | — |
source_urlRequired | string | — |
Raw JSON schema
{
"properties": {
"attempted_at": {
"format": "date-time",
"type": "string"
},
"http_status": {
"format": "int32",
"minimum": 0,
"type": "integer"
},
"prior_receipt_sha256": {
"type": "string"
},
"reason": {
"type": "string"
},
"receipt_sha256": {
"type": "string"
},
"review_required": {
"type": "boolean"
},
"schema_version": {
"format": "int32",
"type": "integer"
},
"source_url": {
"type": "string"
}
},
"required": [
"schema_version",
"http_status",
"attempted_at",
"source_url",
"receipt_sha256",
"prior_receipt_sha256",
"review_required",
"reason"
],
"type": "object"
}DetailHold
| Field | Type | Meaning |
|---|---|---|
failureRequired | DetailFailure | — |
fcc_idRequired | string | — |
held_atRequired | string | — |
source_idRequired | string | — |
Raw JSON schema
{
"properties": {
"failure": {
"$ref": "#/components/schemas/DetailFailure"
},
"fcc_id": {
"type": "string"
},
"held_at": {
"format": "date-time",
"type": "string"
},
"source_id": {
"type": "string"
}
},
"required": [
"source_id",
"fcc_id",
"held_at",
"failure"
],
"type": "object"
}Details
| Field | Type | Meaning |
|---|---|---|
composite_deviceOptional | boolean | null | — |
confidentiality_release_dateOptional | string | null | — |
descriptionOptional | string | null | — |
equipment_classOptional | string | null | — |
evidenceRequired | array<Evidence> | — |
exhibitsRequired | array<Exhibit> | — |
frnOptional | string | null | — |
grant_note_blocksOptional | array<string> | Distinct source note blocks in document order when no single note can be selected. Presence means grant_notes is null; blocks are not merged or interpreted as current conditions. |
grant_notesOptional | string | null | — |
modelsOptional | array<string> | — |
modular_typeOptional | string | null | — |
schema_versionOptional | integer | — |
short_term_confidentialOptional | boolean | null | — |
tcb_scopeOptional | string | null | — |
technicalRequired | array<Technical> | — |
test_firm_nameOptional | string | null | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"composite_device": {
"type": [
"boolean",
"null"
]
},
"confidentiality_release_date": {
"format": "date",
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"equipment_class": {
"type": [
"string",
"null"
]
},
"evidence": {
"items": {
"$ref": "#/components/schemas/Evidence"
},
"type": "array"
},
"exhibits": {
"items": {
"$ref": "#/components/schemas/Exhibit"
},
"type": "array"
},
"frn": {
"type": [
"string",
"null"
]
},
"grant_note_blocks": {
"description": "Distinct source note blocks in document order when no single note can be selected.\nPresence means grant_notes is null; blocks are not merged or interpreted as current conditions.",
"items": {
"type": "string"
},
"type": "array"
},
"grant_notes": {
"type": [
"string",
"null"
]
},
"models": {
"items": {
"type": "string"
},
"type": "array"
},
"modular_type": {
"type": [
"string",
"null"
]
},
"schema_version": {
"format": "int32",
"type": "integer"
},
"short_term_confidential": {
"type": [
"boolean",
"null"
]
},
"tcb_scope": {
"type": [
"string",
"null"
]
},
"technical": {
"items": {
"$ref": "#/components/schemas/Technical"
},
"type": "array"
},
"test_firm_name": {
"type": [
"string",
"null"
]
}
},
"required": [
"technical",
"exhibits",
"evidence"
],
"type": "object"
}ErrorBody
| Field | Type | Meaning |
|---|---|---|
errorRequired | string | — |
Raw JSON schema
{
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"type": "object"
}Evidence
| Field | Type | Meaning |
|---|---|---|
observed_atRequired | string | — |
representationRequired | string | — |
sha256Required | string | — |
urlRequired | string | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"observed_at": {
"format": "date-time",
"type": "string"
},
"representation": {
"type": "string"
},
"sha256": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url",
"sha256",
"observed_at",
"representation"
],
"type": "object"
}Exhibit
| Field | Type | Meaning |
|---|---|---|
attachment_idRequired | string | — |
available_dateOptional | string | null | — |
exhibit_typeOptional | string | null | — |
file_typeOptional | string | null | — |
submitted_dateOptional | string | null | — |
titleOptional | string | null | — |
urlRequired | string | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"attachment_id": {
"type": "string"
},
"available_date": {
"format": "date",
"type": [
"string",
"null"
]
},
"exhibit_type": {
"type": [
"string",
"null"
]
},
"file_type": {
"type": [
"string",
"null"
]
},
"submitted_date": {
"format": "date",
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"required": [
"attachment_id",
"url"
],
"type": "object"
}Frequency
| Field | Type | Meaning |
|---|---|---|
lower_mhzOptional | number | null | — |
upper_mhzOptional | number | null | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"lower_mhz": {
"format": "double",
"type": [
"number",
"null"
]
},
"upper_mhz": {
"format": "double",
"type": [
"number",
"null"
]
}
},
"type": "object"
}Health
| Field | Type | Meaning |
|---|---|---|
statusRequired | string | — |
Raw JSON schema
{
"properties": {
"status": {
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
}Page
| Field | Type | Meaning |
|---|---|---|
applicationsRequired | array<Application> | — |
corpus_scopeRequired | string | — |
countRequired | integer | — |
detail_holdsRequired | array<DetailHold> | — |
next_cursorOptional | string | null | — |
Raw JSON schema
{
"properties": {
"applications": {
"items": {
"$ref": "#/components/schemas/Application"
},
"type": "array"
},
"corpus_scope": {
"type": "string"
},
"count": {
"minimum": 0,
"type": "integer"
},
"detail_holds": {
"items": {
"$ref": "#/components/schemas/DetailHold"
},
"type": "array"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"detail_holds",
"applications",
"count",
"corpus_scope"
],
"type": "object"
}Profile
| Field | Type | Meaning |
|---|---|---|
addressOptional | string | null | — |
cityOptional | string | null | — |
postal_codeOptional | string | null | — |
stateOptional | string | null | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"postal_code": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}Technical
| Field | Type | Meaning |
|---|---|---|
emission_designatorOptional | string | null | — |
frequency_range_mhzOptional | string | null | — |
frequency_toleranceOptional | string | null | — |
note_codesOptional | string | null | — |
output_wattsOptional | string | null | — |
rule_partsOptional | string | null | — |
Raw JSON schema
{
"additionalProperties": false,
"properties": {
"emission_designator": {
"type": [
"string",
"null"
]
},
"frequency_range_mhz": {
"type": [
"string",
"null"
]
},
"frequency_tolerance": {
"type": [
"string",
"null"
]
},
"note_codes": {
"type": [
"string",
"null"
]
},
"output_watts": {
"type": [
"string",
"null"
]
},
"rule_parts": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}Validation
| Field | Type | Meaning |
|---|---|---|
authorizationRequired | string | — |
corpus_scopeRequired | string | — |
covered_equipmentRequired | string | — |
fcc_idRequired | string | — |
live_fcc_checkRequired | boolean | — |
marketing_eligibilityRequired | string | Deliberately never inferred from a partial corpus or a stale grant. |
record_foundRequired | boolean | — |
syntax_validRequired | boolean | — |
Raw JSON schema
{
"properties": {
"authorization": {
"type": "string"
},
"corpus_scope": {
"type": "string"
},
"covered_equipment": {
"type": "string"
},
"fcc_id": {
"type": "string"
},
"live_fcc_check": {
"type": "boolean"
},
"marketing_eligibility": {
"description": "Deliberately never inferred from a partial corpus or a stale grant.",
"type": "string"
},
"record_found": {
"type": "boolean"
},
"syntax_valid": {
"type": "boolean"
}
},
"required": [
"fcc_id",
"syntax_valid",
"record_found",
"authorization",
"marketing_eligibility",
"covered_equipment",
"live_fcc_check",
"corpus_scope"
],
"type": "object"
}