{"components":{"schemas":{"Application":{"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":{"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":{"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":{"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":{"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":{"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":{"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":{"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":{"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"Evidence":{"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":{"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":{"additionalProperties":false,"properties":{"lower_mhz":{"format":"double","type":["number","null"]},"upper_mhz":{"format":"double","type":["number","null"]}},"type":"object"},"Health":{"properties":{"status":{"type":"string"}},"required":["status"],"type":"object"},"Page":{"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":{"additionalProperties":false,"properties":{"address":{"type":["string","null"]},"city":{"type":["string","null"]},"postal_code":{"type":["string","null"]},"state":{"type":["string","null"]}},"type":"object"},"Technical":{"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":{"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"}},"securitySchemes":{"bearerAuth":{"description":"FCC ID API key. REST and MCP share the account allowance.","scheme":"bearer","type":"http"}}},"info":{"description":"Read-only FCC metadata over a growing local corpus. Coverage is incomplete; no live compliance verdicts. The public listener requires a Bearer API key and enforces account quotas. The collector listener is private.","license":{"name":""},"title":"FCC ID API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/health/live":{"get":{"operationId":"live","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":""}},"security":[],"tags":[]}},"/health/ready":{"get":{"operationId":"ready","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":""},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":""}},"security":[],"tags":[]}},"/v1/applications/{id}":{"get":{"operationId":"application","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}},"description":""},"404":{"description":"Application not collected"},"409":{"description":"Source detail requires review"}},"tags":[]}},"/v1/brand":{"get":{"operationId":"brand","parameters":[{"in":"query","name":"brand","required":false,"schema":{"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee_code","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":""},"400":{"description":"brand, q or grantee_code required"}},"tags":[]}},"/v1/bulk":{"post":{"operationId":"public_bulk","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkOutput"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":""},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":""}},"tags":[]}},"/v1/coverage":{"get":{"operationId":"coverage","responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Local corpus counts and recent import receipts; no completeness claim"}},"tags":[]}},"/v1/exhibits/search":{"get":{"operationId":"search","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"in":"query","name":"exhibit_type","required":false,"schema":{"type":"string"}},{"in":"query","name":"stored","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":""}},"tags":[]}},"/v1/exhibits/{id}":{"get":{"operationId":"record","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":""},"404":{"description":"Not in collected metadata"}},"tags":[]}},"/v1/fccid/{id}":{"get":{"operationId":"record","parameters":[{"description":"FCC ID","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Exact FCC ID; punctuation is preserved.","in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"description":"Substring of FCC ID, applicant name or collected product description.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"equipment_class","required":false,"schema":{"type":"string"}},{"description":"EAS observation: granted, not_granted or unknown; not a compliance verdict.","in":"query","name":"grant_status","required":false,"schema":{"type":"string"}},{"description":"Restrict to applications with (or without) collected detail pages.","in":"query","name":"has_details","required":false,"schema":{"type":"boolean"}},{"description":"Missing details, an older projection, source change, or scheduled refresh due.","in":"query","name":"needs_refresh","required":false,"schema":{"type":"boolean"}},{"description":"Queue-only priority ordering; incompatible with cursor pagination.","in":"query","name":"refresh_priority","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Frequency overlap in MHz; both bounds required.","in":"query","name":"lower_mhz","required":false,"schema":{"format":"double","type":"number"}},{"in":"query","name":"upper_mhz","required":false,"schema":{"format":"double","type":"number"}},{"description":"Last application source ID from next_cursor. URL-encode it as a query value.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Default 25, maximum 100 applications.","in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}},"description":""},"404":{"description":"Not in the local corpus; not an FCC invalidity verdict"}},"tags":[]}},"/v1/fccid/{id}/exhibits":{"get":{"operationId":"exhibits","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Exact FCC ID; punctuation is preserved.","in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"description":"Substring of FCC ID, applicant name or collected product description.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"equipment_class","required":false,"schema":{"type":"string"}},{"description":"EAS observation: granted, not_granted or unknown; not a compliance verdict.","in":"query","name":"grant_status","required":false,"schema":{"type":"string"}},{"description":"Restrict to applications with (or without) collected detail pages.","in":"query","name":"has_details","required":false,"schema":{"type":"boolean"}},{"description":"Missing details, an older projection, source change, or scheduled refresh due.","in":"query","name":"needs_refresh","required":false,"schema":{"type":"boolean"}},{"description":"Queue-only priority ordering; incompatible with cursor pagination.","in":"query","name":"refresh_priority","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Frequency overlap in MHz; both bounds required.","in":"query","name":"lower_mhz","required":false,"schema":{"format":"double","type":"number"}},{"in":"query","name":"upper_mhz","required":false,"schema":{"format":"double","type":"number"}},{"description":"Last application source ID from next_cursor. URL-encode it as a query value.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Default 25, maximum 100 applications.","in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Exhibit lists grouped by application with explicit collection status"}},"tags":[]}},"/v1/frequency":{"get":{"operationId":"frequency","parameters":[{"description":"Exact FCC ID; punctuation is preserved.","in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"description":"Substring of FCC ID, applicant name or collected product description.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"equipment_class","required":false,"schema":{"type":"string"}},{"description":"EAS observation: granted, not_granted or unknown; not a compliance verdict.","in":"query","name":"grant_status","required":false,"schema":{"type":"string"}},{"description":"Restrict to applications with (or without) collected detail pages.","in":"query","name":"has_details","required":false,"schema":{"type":"boolean"}},{"description":"Missing details, an older projection, source change, or scheduled refresh due.","in":"query","name":"needs_refresh","required":false,"schema":{"type":"boolean"}},{"description":"Queue-only priority ordering; incompatible with cursor pagination.","in":"query","name":"refresh_priority","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Frequency overlap in MHz; both bounds required.","in":"query","name":"lower_mhz","required":false,"schema":{"format":"double","type":"number"}},{"in":"query","name":"upper_mhz","required":false,"schema":{"format":"double","type":"number"}},{"description":"Last application source ID from next_cursor. URL-encode it as a query value.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Default 25, maximum 100 applications.","in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":""},"400":{"description":"FCC ID or frequency bounds required"}},"tags":[]}},"/v1/grantees":{"get":{"operationId":"grantees","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Historical registry with keyset pagination"}},"tags":[]}},"/v1/grantees/{code}":{"get":{"operationId":"grantee","parameters":[{"in":"path","name":"code","required":true,"schema":{"type":"string"}},{"description":"Exact FCC ID; punctuation is preserved.","in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"description":"Substring of FCC ID, applicant name or collected product description.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"equipment_class","required":false,"schema":{"type":"string"}},{"description":"EAS observation: granted, not_granted or unknown; not a compliance verdict.","in":"query","name":"grant_status","required":false,"schema":{"type":"string"}},{"description":"Restrict to applications with (or without) collected detail pages.","in":"query","name":"has_details","required":false,"schema":{"type":"boolean"}},{"description":"Missing details, an older projection, source change, or scheduled refresh due.","in":"query","name":"needs_refresh","required":false,"schema":{"type":"boolean"}},{"description":"Queue-only priority ordering; incompatible with cursor pagination.","in":"query","name":"refresh_priority","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Frequency overlap in MHz; both bounds required.","in":"query","name":"lower_mhz","required":false,"schema":{"format":"double","type":"number"}},{"in":"query","name":"upper_mhz","required":false,"schema":{"format":"double","type":"number"}},{"description":"Last application source ID from next_cursor. URL-encode it as a query value.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Default 25, maximum 100 applications.","in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Historical registry plus collected applications"}},"tags":[]}},"/v1/lookup":{"get":{"operationId":"lookup","parameters":[{"in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"brand","required":false,"schema":{"type":"string"}},{"in":"query","name":"manufacturer","required":false,"schema":{"type":"string"}},{"in":"query","name":"model","required":false,"schema":{"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":""},"400":{"description":"Invalid matching query"}},"tags":[]}},"/v1/search":{"get":{"operationId":"search","parameters":[{"description":"Exact FCC ID; punctuation is preserved.","in":"query","name":"fccid","required":false,"schema":{"type":"string"}},{"description":"Substring of FCC ID, applicant name or collected product description.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"in":"query","name":"grantee","required":false,"schema":{"type":"string"}},{"in":"query","name":"country","required":false,"schema":{"type":"string"}},{"in":"query","name":"equipment_class","required":false,"schema":{"type":"string"}},{"description":"EAS observation: granted, not_granted or unknown; not a compliance verdict.","in":"query","name":"grant_status","required":false,"schema":{"type":"string"}},{"description":"Restrict to applications with (or without) collected detail pages.","in":"query","name":"has_details","required":false,"schema":{"type":"boolean"}},{"description":"Missing details, an older projection, source change, or scheduled refresh due.","in":"query","name":"needs_refresh","required":false,"schema":{"type":"boolean"}},{"description":"Queue-only priority ordering; incompatible with cursor pagination.","in":"query","name":"refresh_priority","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Frequency overlap in MHz; both bounds required.","in":"query","name":"lower_mhz","required":false,"schema":{"format":"double","type":"number"}},{"in":"query","name":"upper_mhz","required":false,"schema":{"format":"double","type":"number"}},{"description":"Last application source ID from next_cursor. URL-encode it as a query value.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}},{"description":"Default 25, maximum 100 applications.","in":"query","name":"limit","required":false,"schema":{"format":"int32","minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}},"description":""},"400":{"description":"Invalid filter"},"503":{"description":"Database unavailable"}},"tags":[]}},"/v1/validate":{"get":{"operationId":"validate","parameters":[{"in":"query","name":"fccid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Validation"}}},"description":""}},"tags":[]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.fccidapi.com"}]}