{ "openapi": "3.1.0", "info": { "title": "FCCID.io API", "version": "1.0.0", "description": "FCC ID discovery, exact-record validation, and granted frequencies. All four data endpoints are available on Free and paid plans. Free includes 100 total queries per UTC calendar month shared across endpoints and keys, limited to 10 requests/minute; requests stop at the hard quota. Signup required; email verification is optional. valid=true confirms an FCC-sourced record; product-match certainty and authorization status are independent.", "contact": { "email": "info@fccid.io" } }, "servers": [ { "url": "https://api.fccid.io" } ], "security": [ { "bearerAuth": [] } ], "paths": { "/lookup": { "get": { "operationId": "lookup", "summary": "Find relevant FCC IDs", "description": "Available on Development / Free and paid plans. Commercial use is permitted on all plans, and linkback is optional. Free accounts share 100 total completed queries per UTC calendar month across all four data endpoints and all keys, with a 10-request-per-minute limit. Required source failures, invalid input, and malformed FCC ID checks use no monthly quota. Completed no-match results count. Hard monthly limits apply; no automatic overages.", "parameters": [ { "name": "fccid", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "brand", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "model", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "manufacturer", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "ean", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 }, "description": "Checksum-valid EAN, UPC, or GTIN used to discover FCC IDs. Returns FCC candidates, not standalone barcode records; leading zeros preserved." }, { "name": "mpn", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "title", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } } ], "responses": { "200": { "description": "Completed query; results may be unconfirmed or empty", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Available queries in the current billing period", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "Next monthly quota reset as an ISO 8601 timestamp", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response" }, "examples": { "product": { "summary": "Product search", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000001", "status": "matches", "matches": [ { "fccid": "2AXH6-SPARKXI8", "valid": true, "applicant": "Shenzhen Creality 3D Technology Co.,Ltd.", "manufacturer": null, "brand": null, "models": [ "SPARKXI8" ], "product": "3D Printer", "equipment_class": "DTS - Digital Transmission System", "latest_filing_date": "2026-10-16", "authorization": { "status": "granted", "as_of": "2026-10-16", "evidence": [ { "application_id": "xzxVY4/Wa74mXxajj94ezA==", "status": "granted", "date": "2026-10-16", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/2AXH6-SPARKXI8" } ] }, "match": { "status": "candidate", "method": "document_text", "reasons": [ "FCC document content matches the product query." ] }, "evidence": [ { "kind": "fcc_application", "application_id": "xzxVY4/Wa74mXxajj94ezA==", "url": "https://fccid.io/2AXH6-SPARKXI8", "date": "2026-10-16" }, { "kind": "fcc_document", "document_id": 9736191, "application_id": "xzxVY4/Wa74mXxajj94ezA==", "sha256": "6653576106d51bf2263f95d43d09ae0fbdb8a5b296d11e96e028e44329a5c5ca", "title": "Test Report", "url": "https://fccid.io/document.php?id=9736191" } ], "links": { "fccid": "https://fccid.io/2AXH6-SPARKXI8" }, "news": [], "warnings": [] } ], "search": { "literal_model": "SPARKXI8", "expanded_terms": [ "SPARKXI8", "5PARKXI8", "SPARKX18", "SPARKXL8", "SPARKXIB" ] }, "corrections": [], "barcode": null, "warnings": [], "checked_at": "2026-11-03T19:50:00.000Z", "verification_source": "FCC-sourced records held by FCCID.io", "cache": "miss", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" } } }, "ean": { "summary": "Direct EAN association", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000002", "status": "matches", "matches": [ { "fccid": "2BNTC-BTS50H", "valid": true, "applicant": "JMTEK TECHNOLOGY(ZHONGSHAN) CO., LTD", "manufacturer": null, "brand": null, "models": [ "BTS50H" ], "product": "Transparent Wireless Speaker", "equipment_class": "DSS - Part 15 Spread Spectrum Transmitter", "latest_filing_date": "2026-10-30", "authorization": { "status": "granted", "as_of": "2026-10-30", "evidence": [ { "application_id": "jBNV/rPyLGJ5ajfl2lgUzg==", "status": "granted", "date": "2026-10-30", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/2BNTC-BTS50H" } ] }, "match": { "status": "candidate", "method": "exact_ean_record", "reasons": [ "The exact normalized GTIN is recorded in a published FCC exhibit associated with this FCC ID. Physical product identity remains unconfirmed." ] }, "evidence": [ { "kind": "fcc_application", "application_id": "jBNV/rPyLGJ5ajfl2lgUzg==", "url": "https://fccid.io/2BNTC-BTS50H", "date": "2026-10-30" }, { "kind": "fcc_document", "document_id": 9775360, "application_id": "jBNV/rPyLGJ5ajfl2lgUzg==", "sha256": "14187a1c043f40927dfa505f15f00bfc3805948035d52998fa5aa13bf5d3ec8e", "title": "ID label and location", "url": "https://fccid.io/document.php?id=9775360" }, { "kind": "fcc_ean_association", "gtin14": "05020309001701", "barcode_id": 4230, "document_id": 9775360, "application_id": "jBNV/rPyLGJ5ajfl2lgUzg==", "fccid": "2BNTC-BTS50H", "sha256": "14187a1c043f40927dfa505f15f00bfc3805948035d52998fa5aa13bf5d3ec8e", "source_url": "https://fccid.io/document.php?id=9775360", "observed_at": "2026-10-31 05:01:20", "reference": "61191bce1c8ad31d22d9106323ca5dcf43599336c7a9def17cf2066063fb249c" } ], "links": { "fccid": "https://fccid.io/2BNTC-BTS50H" }, "news": [], "warnings": [] } ], "corrections": [], "direct_records_truncated": false, "news": [], "warnings": [], "ean_resolution": { "gtin14": "05020309001701", "status": "fcc_candidates_found", "clue_source": "fcc_records", "direct_record_matches": 1, "product_association": "unconfirmed" }, "checked_at": "2026-11-03T19:50:00.000Z", "verification_source": "FCC-sourced records held by FCCID.io", "cache": "miss", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "unknown_parameter": { "summary": "unknown_parameter", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "unknown_parameter", "message": "Unknown parameter: unsupported" } } } } } } }, "401": { "description": "Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "api_key_required": { "summary": "api_key_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "api_key_required", "message": "Use Authorization: Bearer YOUR_API_KEY." } } } } } } }, "403": { "description": "Access not activated or expired", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "license_required": { "summary": "license_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "license_required", "message": "Activate Development / Free or renew your subscription." } } } } } } }, "410": { "description": "Withdrawn record", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "record_withdrawn": { "summary": "record_withdrawn", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "record_withdrawn", "message": "This record is withdrawn from public access." } } } } } } }, "429": { "description": "Rate or monthly quota exceeded", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds until the rejected limit resets", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "rate_limit": { "summary": "rate_limit", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "rate_limit", "message": "Request rate exceeded." }, "rate_limit": { "limit": 10, "remaining": 0, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } }, "quota_exceeded": { "summary": "quota_exceeded", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "quota_exceeded", "message": "Monthly quota reached. Upgrade or wait for the reset." }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } } } } } }, "503": { "description": "Data or verification unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "data_unavailable": { "summary": "data_unavailable", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "data_unavailable", "message": "FCC data is temporarily unavailable." } } } } } } } } } }, "/validate": { "get": { "operationId": "validate", "summary": "Check an exact FCC ID record", "description": "Available on Development / Free and paid plans. Commercial use is permitted on all plans, and linkback is optional. Free accounts share 100 total completed queries per UTC calendar month across all four data endpoints and all keys, with a 10-request-per-minute limit. Required source failures, invalid input, and malformed FCC ID checks use no monthly quota. Completed no-match results count. Hard monthly limits apply; no automatic overages.", "parameters": [ { "name": "fccid", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 256 } } ], "responses": { "200": { "description": "Completed query; results may be unconfirmed or empty", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Available queries in the current billing period", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "Next monthly quota reset as an ISO 8601 timestamp", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response" }, "examples": { "confirmed": { "summary": "Confirmed FCC ID with a historical grant", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000003", "status": "confirmed", "input": "A4RH2G2-42", "sources": [ { "kind": "fcc_application", "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "url": "https://fccid.io/A4RH2G2-42", "date": "2013-05-17" } ], "fccid": "A4RH2G2-42", "valid": true, "applicant": "Google LLC", "manufacturer": null, "brand": null, "models": [ "H2G2-42" ], "product": "H840 Device", "equipment_class": "DTS - Digital Transmission System", "latest_filing_date": "2013-05-17", "authorization": { "status": "granted", "as_of": "2013-05-17", "evidence": [ { "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "status": "granted", "date": "2013-05-17", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/A4RH2G2-42" } ] }, "match": { "status": "identifier_match", "method": "exact_fccid", "reasons": [ "Exact FCC-sourced identifier record." ] }, "evidence": [ { "kind": "fcc_application", "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "url": "https://fccid.io/A4RH2G2-42", "date": "2013-05-17" } ], "links": { "fccid": "https://fccid.io/A4RH2G2-42" }, "news": [], "warnings": [], "checked_at": "2026-11-03T19:50:00.000Z", "screening": { "schema_version": "1", "purpose": "us_marketplace_fcc_id_screening", "assessed_at": "2026-11-03T19:50:00.000Z", "rules_reviewed_at": "2026-11-02", "rules_url": "https://api.fccid.io/marketplace-rules.json", "guide_url": "https://api.fccid.io/compliance", "marketing_eligibility": "undetermined", "review_required": true, "checks": { "fcc_id_record": { "status": "confirmed", "basis": "FCC-sourced records held by FCCID.io", "evidence": [ { "kind": "fcc_application", "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "url": "https://fccid.io/A4RH2G2-42", "date": "2013-05-17" } ] }, "recorded_grant": { "status": "observed", "as_of": "2013-05-17" }, "product_association": { "status": "not_verified" }, "current_authorization": { "status": "unknown" }, "fcc_eas_live_check": { "status": "not_performed" }, "covered_equipment": { "status": "not_assessed" }, "listing_display_requirement": { "status": "requires_listing_context" }, "seller_accuracy_certification": { "status": "not_collected" }, "published_warnings": { "status": "none_found_in_covered_sources", "count": 0, "coverage": "Published items explicitly linked to this FCC ID; not comprehensive enforcement or recall coverage." } }, "next_actions": [ "verify_product_label_and_model", "check_current_fcc_authorization_and_restrictions", "determine_certification_or_sdoc_path", "review_listing_scope_deadline_and_exceptions", "collect_seller_accuracy_certification_when_applicable", "retain_response_and_product_evidence" ], "official_verification_url": "https://apps.fcc.gov/oetcf/eas/reports/GenericSearch.cfm", "limitations": "A confirmed record does not establish product identity, current marketing permission, Covered List clearance, or compliance certification. FCCID.io does not perform a live FCC EAS check in this response." }, "verification_source": "FCC-sourced records held by FCCID.io", "cache": "hit", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" } } }, "unconfirmed": { "summary": "Plausible FCC ID with no confirmed record", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000003", "checked_at": "2026-11-03T19:50:00.000Z", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" }, "status": "not_found", "valid": null, "input": "ZZZUNCONFIRMED99", "authorization": { "status": "unknown", "as_of": null, "evidence": [] }, "sources": [], "news": [], "warnings": [], "screening": { "schema_version": "1", "purpose": "us_marketplace_fcc_id_screening", "assessed_at": "2026-11-03T19:50:00.000Z", "rules_reviewed_at": "2026-11-02", "rules_url": "https://api.fccid.io/marketplace-rules.json", "guide_url": "https://api.fccid.io/compliance", "marketing_eligibility": "undetermined", "review_required": true, "checks": { "fcc_id_record": { "status": "unconfirmed", "basis": "FCC-sourced records held by FCCID.io", "evidence": [] }, "recorded_grant": { "status": "unknown", "as_of": null }, "product_association": { "status": "not_verified" }, "current_authorization": { "status": "unknown" }, "fcc_eas_live_check": { "status": "not_performed" }, "covered_equipment": { "status": "not_assessed" }, "listing_display_requirement": { "status": "requires_listing_context" }, "seller_accuracy_certification": { "status": "not_collected" }, "published_warnings": { "status": "none_found_in_covered_sources", "count": 0, "coverage": "Published items explicitly linked to this FCC ID; not comprehensive enforcement or recall coverage." } }, "next_actions": [ "verify_identifier_in_fcc_eas", "check_current_fcc_authorization_and_restrictions", "determine_certification_or_sdoc_path", "review_listing_scope_deadline_and_exceptions", "collect_seller_accuracy_certification_when_applicable", "retain_response_and_product_evidence" ], "official_verification_url": "https://apps.fcc.gov/oetcf/eas/reports/GenericSearch.cfm", "limitations": "A confirmed record does not establish product identity, current marketing permission, Covered List clearance, or compliance certification. FCCID.io does not perform a live FCC EAS check in this response." }, "cache": "miss", "verification_source": "FCC-sourced records held by FCCID.io" } }, "suggested_alternative": { "summary": "Unconfirmed FCC ID with a suggested correction", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000003", "checked_at": "2026-11-03T19:50:00.000Z", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" }, "status": "not_found", "valid": null, "input": "A4RH2G2-4Z", "authorization": { "status": "unknown", "as_of": null, "evidence": [] }, "suggestions": [ { "fccid": "A4RH2G2-42", "basis": "confusable_character", "url": "https://fccid.io/A4RH2G2-42" } ], "sources": [], "news": [], "warnings": [], "screening": { "schema_version": "1", "purpose": "us_marketplace_fcc_id_screening", "assessed_at": "2026-11-03T19:50:00.000Z", "rules_reviewed_at": "2026-11-02", "rules_url": "https://api.fccid.io/marketplace-rules.json", "guide_url": "https://api.fccid.io/compliance", "marketing_eligibility": "undetermined", "review_required": true, "checks": { "fcc_id_record": { "status": "unconfirmed", "basis": "FCC-sourced records held by FCCID.io", "evidence": [] }, "recorded_grant": { "status": "unknown", "as_of": null }, "product_association": { "status": "not_verified" }, "current_authorization": { "status": "unknown" }, "fcc_eas_live_check": { "status": "not_performed" }, "covered_equipment": { "status": "not_assessed" }, "listing_display_requirement": { "status": "requires_listing_context" }, "seller_accuracy_certification": { "status": "not_collected" }, "published_warnings": { "status": "none_found_in_covered_sources", "count": 0, "coverage": "Published items explicitly linked to this FCC ID; not comprehensive enforcement or recall coverage." } }, "next_actions": [ "verify_identifier_in_fcc_eas", "check_current_fcc_authorization_and_restrictions", "determine_certification_or_sdoc_path", "review_listing_scope_deadline_and_exceptions", "collect_seller_accuracy_certification_when_applicable", "retain_response_and_product_evidence" ], "official_verification_url": "https://apps.fcc.gov/oetcf/eas/reports/GenericSearch.cfm", "limitations": "A confirmed record does not establish product identity, current marketing permission, Covered List clearance, or compliance certification. FCCID.io does not perform a live FCC EAS check in this response." }, "cache": "miss", "verification_source": "FCC-sourced records held by FCCID.io" } }, "malformed": { "summary": "Malformed identifier", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000003", "checked_at": "2026-11-03T19:50:00.000Z", "usage": { "plan": "free", "quota": 100, "used": 11, "remaining": 89, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" }, "status": "invalid_syntax", "valid": false, "input": "??", "authorization": { "status": "unknown" }, "sources": [], "news": [], "warnings": [], "screening": { "schema_version": "1", "purpose": "us_marketplace_fcc_id_screening", "assessed_at": "2026-11-03T19:50:00.000Z", "rules_reviewed_at": "2026-11-02", "rules_url": "https://api.fccid.io/marketplace-rules.json", "guide_url": "https://api.fccid.io/compliance", "marketing_eligibility": "undetermined", "review_required": true, "checks": { "fcc_id_record": { "status": "invalid_syntax", "basis": "FCC-sourced records held by FCCID.io", "evidence": [] }, "recorded_grant": { "status": "unknown", "as_of": null }, "product_association": { "status": "not_verified" }, "current_authorization": { "status": "unknown" }, "fcc_eas_live_check": { "status": "not_performed" }, "covered_equipment": { "status": "not_assessed" }, "listing_display_requirement": { "status": "requires_listing_context" }, "seller_accuracy_certification": { "status": "not_collected" }, "published_warnings": { "status": "none_found_in_covered_sources", "count": 0, "coverage": "Published items explicitly linked to this FCC ID; not comprehensive enforcement or recall coverage." } }, "next_actions": [ "correct_identifier", "check_current_fcc_authorization_and_restrictions", "determine_certification_or_sdoc_path", "review_listing_scope_deadline_and_exceptions", "collect_seller_accuracy_certification_when_applicable", "retain_response_and_product_evidence" ], "official_verification_url": "https://apps.fcc.gov/oetcf/eas/reports/GenericSearch.cfm", "limitations": "A confirmed record does not establish product identity, current marketing permission, Covered List clearance, or compliance certification. FCCID.io does not perform a live FCC EAS check in this response." } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "unknown_parameter": { "summary": "unknown_parameter", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "unknown_parameter", "message": "Unknown parameter: unsupported" } } } } } } }, "401": { "description": "Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "api_key_required": { "summary": "api_key_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "api_key_required", "message": "Use Authorization: Bearer YOUR_API_KEY." } } } } } } }, "403": { "description": "Access not activated or expired", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "license_required": { "summary": "license_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "license_required", "message": "Activate Development / Free or renew your subscription." } } } } } } }, "410": { "description": "Withdrawn record", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "record_withdrawn": { "summary": "record_withdrawn", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "record_withdrawn", "message": "This record is withdrawn from public access." } } } } } } }, "429": { "description": "Rate or monthly quota exceeded", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds until the rejected limit resets", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "rate_limit": { "summary": "rate_limit", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "rate_limit", "message": "Request rate exceeded." }, "rate_limit": { "limit": 10, "remaining": 0, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } }, "quota_exceeded": { "summary": "quota_exceeded", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "quota_exceeded", "message": "Monthly quota reached. Upgrade or wait for the reset." }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } } } } } }, "503": { "description": "Data or verification unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "data_unavailable": { "summary": "data_unavailable", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "data_unavailable", "message": "FCC data is temporarily unavailable." } } } } } } } } } }, "/frequency": { "get": { "operationId": "frequency", "summary": "Retrieve granted frequencies", "description": "Available on Development / Free and paid plans. Commercial use is permitted on all plans, and linkback is optional. Free accounts share 100 total completed queries per UTC calendar month across all four data endpoints and all keys, with a 10-request-per-minute limit. Required source failures, invalid input, and malformed FCC ID checks use no monthly quota. Completed no-match results count. Hard monthly limits apply; no automatic overages.", "parameters": [ { "name": "fccid", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 256 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 }, "description": "Opaque next_cursor from the previous response" } ], "responses": { "200": { "description": "Completed query; results may be unconfirmed or empty", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Available queries in the current billing period", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "Next monthly quota reset as an ISO 8601 timestamp", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response" }, "examples": { "granted": { "summary": "Granted frequency ranges", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000004", "status": "confirmed", "input": "A4RH2G2-42", "sources": [ { "kind": "fcc_application", "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "url": "https://fccid.io/A4RH2G2-42", "date": "2013-05-17" } ], "fccid": "A4RH2G2-42", "valid": true, "applicant": "Google LLC", "manufacturer": null, "brand": null, "models": [ "H2G2-42" ], "product": "H840 Device", "equipment_class": "DTS - Digital Transmission System", "latest_filing_date": "2013-05-17", "authorization": { "status": "granted", "as_of": "2013-05-17", "evidence": [ { "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "status": "granted", "date": "2013-05-17", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/A4RH2G2-42" } ] }, "match": { "status": "identifier_match", "method": "exact_fccid", "reasons": [ "Exact FCC-sourced identifier record." ] }, "evidence": [ { "kind": "fcc_application", "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "url": "https://fccid.io/A4RH2G2-42", "date": "2013-05-17" } ], "links": { "fccid": "https://fccid.io/A4RH2G2-42" }, "news": [], "warnings": [], "frequencies": [ { "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "lower_mhz": 2412, "upper_mhz": 2462, "power_output": "0.0646", "power_output_unit": "W", "emission_designator": null, "rule_parts": "15C", "grant_date": "2013-05-17", "source_url": "https://fccid.io/A4RH2G2-42" }, { "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "lower_mhz": 2412, "upper_mhz": 2462, "power_output": "0.1047", "power_output_unit": "W", "emission_designator": null, "rule_parts": "15C", "grant_date": "2013-05-17", "source_url": "https://fccid.io/A4RH2G2-42" }, { "application_id": "f0j7HF8eqysxKMxHa1LE+g==", "lower_mhz": 2412, "upper_mhz": 2462, "power_output": "0.0692", "power_output_unit": "W", "emission_designator": null, "rule_parts": "15C", "grant_date": "2013-05-17", "source_url": "https://fccid.io/A4RH2G2-42" } ], "frequency_status": "known", "frequency_coverage": { "complete": true, "max_grant_applications": 100, "max_fallback_rows": 500 }, "next_cursor": null, "checked_at": "2026-11-03T19:50:00.000Z", "verification_source": "FCC-sourced records held by FCCID.io", "cache": "hit", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "unknown_parameter": { "summary": "unknown_parameter", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "unknown_parameter", "message": "Unknown parameter: unsupported" } } } } } } }, "401": { "description": "Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "api_key_required": { "summary": "api_key_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "api_key_required", "message": "Use Authorization: Bearer YOUR_API_KEY." } } } } } } }, "403": { "description": "Access not activated or expired", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "license_required": { "summary": "license_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "license_required", "message": "Activate Development / Free or renew your subscription." } } } } } } }, "410": { "description": "Withdrawn record", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "record_withdrawn": { "summary": "record_withdrawn", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "record_withdrawn", "message": "This record is withdrawn from public access." } } } } } } }, "429": { "description": "Rate or monthly quota exceeded", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds until the rejected limit resets", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "rate_limit": { "summary": "rate_limit", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "rate_limit", "message": "Request rate exceeded." }, "rate_limit": { "limit": 10, "remaining": 0, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } }, "quota_exceeded": { "summary": "quota_exceeded", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "quota_exceeded", "message": "Monthly quota reached. Upgrade or wait for the reset." }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } } } } } }, "503": { "description": "Data or verification unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "data_unavailable": { "summary": "data_unavailable", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "data_unavailable", "message": "FCC data is temporarily unavailable." } } } } } } } } } }, "/brand": { "get": { "operationId": "brand", "summary": "Latest FCC IDs across matching grantees", "description": "Available on Development / Free and paid plans. Commercial use is permitted on all plans, and linkback is optional. Free accounts share 100 total completed queries per UTC calendar month across all four data endpoints and all keys, with a 10-request-per-minute limit. Required source failures, invalid input, and malformed FCC ID checks use no monthly quota. Completed no-match results count. Hard monthly limits apply; no automatic overages.", "parameters": [ { "name": "brand", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "grantee_code", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 256 } } ], "responses": { "200": { "description": "Completed query; results may be unconfirmed or empty", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "X-Quota-Remaining": { "description": "Available queries in the current billing period", "schema": { "type": "integer" } }, "X-Quota-Reset": { "description": "Next monthly quota reset as an ISO 8601 timestamp", "schema": { "type": "string", "format": "date-time" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response" }, "examples": { "grantee": { "summary": "Brand query with a matching FCC grantee", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000005", "status": "matches", "query": "Apple", "grantees": [ { "code": "2AN3R", "name": "Apple Inc.", "match_basis": "grantee_name", "url": "https://fccid.io/2AN3R" }, { "code": "2AN3S", "name": "Apple Inc.", "match_basis": "grantee_name", "url": "https://fccid.io/2AN3S" }, { "code": "2AN3T", "name": "Apple Inc.", "match_basis": "grantee_name", "url": "https://fccid.io/2AN3T" }, { "code": "BCG", "name": "Apple Inc.", "match_basis": "grantee_name", "url": "https://fccid.io/BCG" } ], "grantees_truncated": false, "matches": [ { "fccid": "BCGA3375", "valid": true, "applicant": "Apple Inc.", "manufacturer": null, "brand": null, "models": [ "A3375" ], "product": "Laptop Computer", "equipment_class": "NII - Unlicensed National Information Infrastructure TX", "latest_filing_date": "2026-10-28", "authorization": { "status": "granted", "as_of": "2026-10-28", "evidence": [ { "application_id": "CWzckFH+s+8buBSoGqj6qA==", "status": "granted", "date": "2026-10-28", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/BCGA3375" }, { "application_id": "UT3fR6m7LYf2fGm0c9LWOw==", "status": "granted", "date": "2026-10-28", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/BCGA3375" }, { "application_id": "lk8afS56JGuejwNku3VNag==", "status": "granted", "date": "2026-10-28", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/BCGA3375" }, { "application_id": "lwfojLaHCPue2MpC805SyA==", "status": "granted", "date": "2026-10-28", "basis": "grant_tcb", "observed_at": null, "source_url": "https://fccid.io/BCGA3375" } ] }, "match": { "status": "candidate", "method": "grantee_record", "reasons": [ "FCC record filed under a matching grantee." ] }, "evidence": [ { "kind": "fcc_application", "application_id": "ypm8cxwW6PF3UD7a3K2xrw==", "url": "https://fccid.io/BCGA3375", "date": "2026-10-28" } ], "links": { "fccid": "https://fccid.io/BCGA3375" }, "news": [], "warnings": [], "grantee_code": "BCG" } ], "relationship_note": "Names match the supplied query. Grantee identity and consumer-brand ownership are distinct.", "checked_at": "2026-11-03T19:50:00.000Z", "verification_source": "FCC-sourced records held by FCCID.io", "cache": "miss", "usage": { "plan": "free", "quota": 100, "used": 12, "remaining": 88, "resets_at": "2026-12-01T00:00:00.000Z" }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 }, "license": { "commercial": true, "attribution_required": false, "attribution_url": "https://fccid.io" } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "unknown_parameter": { "summary": "unknown_parameter", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "unknown_parameter", "message": "Unknown parameter: unsupported" } } } } } } }, "401": { "description": "Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "api_key_required": { "summary": "api_key_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "api_key_required", "message": "Use Authorization: Bearer YOUR_API_KEY." } } } } } } }, "403": { "description": "Access not activated or expired", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "license_required": { "summary": "license_required", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "license_required", "message": "Activate Development / Free or renew your subscription." } } } } } } }, "410": { "description": "Withdrawn record", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "record_withdrawn": { "summary": "record_withdrawn", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "record_withdrawn", "message": "This record is withdrawn from public access." } } } } } } }, "429": { "description": "Rate or monthly quota exceeded", "headers": { "X-RateLimit-Limit": { "description": "Account requests per fixed UTC minute", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Remaining account requests in this minute", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Next UTC-minute boundary as Unix seconds", "schema": { "type": "integer" } }, "Retry-After": { "description": "Seconds until the rejected limit resets", "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "rate_limit": { "summary": "rate_limit", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "rate_limit", "message": "Request rate exceeded." }, "rate_limit": { "limit": 10, "remaining": 0, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } }, "quota_exceeded": { "summary": "quota_exceeded", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "quota_exceeded", "message": "Monthly quota reached. Upgrade or wait for the reset." }, "rate_limit": { "limit": 10, "remaining": 9, "resets_at": "2026-11-03T19:51:00.000Z", "window_seconds": 60 } } } } } } }, "503": { "description": "Data or verification unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "examples": { "data_unavailable": { "summary": "data_unavailable", "value": { "api_version": "1", "request_id": "00000000-0000-4000-8000-000000000006", "error": { "code": "data_unavailable", "message": "FCC data is temporarily unavailable." } } } } } } } } } }, "/status.json": { "get": { "operationId": "status", "summary": "Backing FCC records, document search, and barcode/EAN health", "security": [], "responses": { "200": { "description": "Operational or degraded component status with freshness context", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceStatus" }, "examples": { "operational": { "summary": "All services operational", "value": { "api_version": "1", "status": "operational", "checked_at": "2026-11-03T19:48:52.604Z", "services": { "fccid_records": { "name": "FCCID.io database", "status": "operational", "latest_filing_date": "2026-11-03" }, "fccid_documents": { "name": "FCC document search in OpenSearch", "status": "operational" }, "barcode_ean": { "name": "Barcode.report active product and EAN reader", "status": "operational", "check": "Fresh product-reader request", "sample_observed_at": "2026-09-16 21:01:09" } } } }, "degraded": { "summary": "Document search unavailable", "value": { "api_version": "1", "status": "degraded", "checked_at": "2026-11-03T19:48:52.604Z", "services": { "fccid_records": { "name": "FCCID.io database", "status": "operational", "latest_filing_date": "2026-11-03" }, "fccid_documents": { "name": "FCC document search in OpenSearch", "status": "unavailable" }, "barcode_ean": { "name": "Barcode.report active product and EAN reader", "status": "operational", "check": "Fresh product-reader request", "sample_observed_at": "2026-09-16 21:01:09" } } } } } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "FCCID API key" } }, "schemas": { "Response": { "type": "object", "required": [ "api_version", "request_id", "status" ], "properties": { "api_version": { "type": "string", "const": "1", "description": "Response contract version. Currently 1." }, "request_id": { "type": "string", "description": "Unique ID for this request. Include it when asking for support." }, "status": { "type": "string", "enum": [ "confirmed", "matches", "not_found", "invalid_syntax" ], "description": "Outcome of the query. matches means candidates were returned, confirmed means an exact record was found, not_found means no matching record was confirmed, and invalid_syntax means the supplied FCC ID is malformed." }, "valid": { "type": [ "boolean", "null" ], "description": "true confirms an FCC-sourced record, false indicates malformed syntax, and null means a plausible identifier was unconfirmed. For candidates, true refers to the record itself." }, "fccid": { "type": "string", "description": "Canonical FCC identifier recorded by FCCID.io." }, "matches": { "type": "array", "maxItems": 10, "items": { "$ref": "#/components/schemas/Candidate" }, "description": "Returned FCC ID candidates. Lookup ranks by relevance and brand returns recent filings." }, "frequencies": { "type": "array", "items": { "$ref": "#/components/schemas/Frequency" }, "description": "Page of supported grant frequency records. Empty when no rows were found or the page is exhausted." }, "frequency_status": { "type": "string", "enum": [ "known", "unknown" ], "description": "known when supported ranges were found for the record, otherwise unknown." }, "authorization": { "$ref": "#/components/schemas/Authorization", "description": "Historical FCC decision evidence. See the authorization fields below." }, "ean_resolution": { "$ref": "#/components/schemas/EanResolution", "description": "How the barcode was used to find FCC IDs." }, "corrections": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Input field corrected when the response identifies it." }, "from": { "type": "string", "description": "Original value." }, "to": { "type": "string", "description": "Candidate value after substitution." }, "basis": { "type": "string", "description": "Why the substitution was proposed, when provided." } } }, "description": "Reported character substitutions. An empty array means none were reported." }, "news": { "type": "array", "items": { "$ref": "#/components/schemas/Article" }, "description": "Published articles linked to the FCC ID. An empty array means none were found in covered sources." }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/Article" }, "description": "Linked warnings, recalls or enforcement items in covered sources. An empty array means none were found there." }, "sources": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "description": "Source evidence for the exact record." }, "screening": { "$ref": "#/components/schemas/Screening", "description": "Marketplace evidence and review checklist. Present on validation responses." }, "checked_at": { "type": "string", "format": "date-time", "description": "UTC time the API assembled and checked the response against its covered data." }, "next_cursor": { "type": [ "string", "null" ], "description": "Send this string as cursor to fetch the next page. Null means there is no next page." }, "rate_limit": { "$ref": "#/components/schemas/RateLimit", "description": "Account allowance in the current UTC minute. Shared across keys and data endpoints." }, "usage": { "type": "object", "properties": { "remaining": { "type": "integer", "description": "Available queries after completed usage and any in-flight reservations." }, "used": { "type": "integer", "description": "Completed queries charged in that period." }, "quota": { "type": "integer", "description": "Total query allowance for the current billing period." }, "resets_at": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp for the next quota reset." }, "plan": { "enum": [ "free", "starter", "business", "scale", "enterprise" ], "description": "Plan code. free, starter, business, scale, or enterprise." } }, "description": "Monthly usage for the calling account after the request is processed." }, "input": { "type": "string", "description": "Submitted FCC ID after request input normalization." }, "applicant": { "type": [ "string", "null" ], "description": "Name of the FCC applicant, or null if unavailable." }, "manufacturer": { "type": [ "string", "null" ], "description": "Identified manufacturer, or null if unavailable." }, "brand": { "type": [ "string", "null" ], "description": "Identified consumer brand, or null if unavailable." }, "models": { "type": "array", "items": { "type": "string" }, "description": "Model names recorded in the covered applications." }, "product": { "type": [ "string", "null" ], "description": "Equipment description, or null if unavailable." }, "equipment_class": { "type": [ "string", "null" ], "description": "FCC equipment class code, or null if unavailable." }, "latest_filing_date": { "type": [ "string", "null" ], "description": "Latest final-action date found in the covered records, or null." }, "match": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "identifier_match", "candidate" ], "description": "identifier_match for an exact identifier match or candidate for a search result that needs review." }, "method": { "type": "string", "description": "Selection method. exact_fccid, exact_ean_record, barcode_record, applicant_model, document_text, character_variant, or grantee_record." }, "reasons": { "type": "array", "items": { "type": "string" }, "description": "Human-readable explanations for the selection." } }, "description": "How this FCC record was selected." }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "description": "Source records supporting the match. Fields vary by source kind." }, "links": { "type": "object", "properties": { "fccid": { "type": "string", "format": "uri", "description": "FCCID.io record page." }, "barcode": { "type": "string", "format": "uri", "description": "Barcode.report link when supporting barcode clues were used." } }, "description": "Relevant links for the record." }, "search": { "type": "object", "properties": { "literal_model": { "type": [ "string", "null" ], "description": "Model or part number used before expansion, or null." }, "expanded_terms": { "type": "array", "items": { "type": "string" }, "description": "Bounded list of tried spellings, including the original term when available." } }, "description": "Search diagnostics when search terms were expanded." }, "suggestions": { "type": "array", "items": { "type": "object", "properties": { "fccid": { "type": "string", "description": "Canonical FCC ID of the suggested record." }, "basis": { "enum": [ "formatting", "confusable_character", "adjacent_transposition" ], "description": "formatting for the same ID with its recorded punctuation, confusable_character for one visually similar character, or adjacent_transposition for two neighboring characters in reverse order." }, "url": { "type": "string", "format": "uri", "description": "FCCID.io page for the suggested record." } } }, "description": "Verified FCC records offered as alternatives for an identifier search. An empty array means none of the checked spellings produced a public record." }, "barcode": { "type": "null", "description": "Legacy field. Ordinary lookup can return null. EAN lookup uses ean_resolution instead." }, "direct_records_truncated": { "type": "boolean", "description": "True when the direct FCC barcode search reached its source row limit. Present on applicable EAN lookups." }, "query": { "type": "string", "description": "Brand or grantee search term used for the query." }, "grantees": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "FCC grantee code." }, "name": { "type": [ "string", "null" ], "description": "Registered grantee name, or null." }, "match_basis": { "type": "string", "description": "exact_grantee_code or grantee_name." }, "url": { "type": "string", "description": "FCCID.io grantee page." } } }, "description": "Matching FCC grantees considered for the latest filing results." }, "grantees_truncated": { "type": "boolean", "description": "True when matching grantees exceeded the 20-grantee limit." }, "relationship_note": { "type": "string", "description": "Explains the scope of the grantee relationship." }, "frequency_coverage": { "type": "object", "properties": { "complete": { "type": [ "boolean", "null" ], "description": "True when the source limits were not exceeded, false when results were truncated, or null when the FCC record was unconfirmed." }, "max_grant_applications": { "type": "integer", "minimum": 0, "description": "Maximum number of grant applications considered." }, "max_fallback_rows": { "type": "integer", "minimum": 0, "description": "Maximum number of indexed equipment specification rows considered when grant HTML supplies no usable ranges." } }, "description": "Limits applied to the grant and frequency records examined." }, "verification_source": { "type": "string", "description": "Description of the FCC data used for the check. Absent when input syntax fails." }, "cache": { "enum": [ "hit", "miss" ], "description": "hit or miss for the shared data cache. Publication rules are checked on either path." }, "license": { "type": "object", "properties": { "commercial": { "type": "boolean", "description": "Whether commercial use is allowed." }, "attribution_required": { "type": "boolean", "description": "Whether visible attribution is mandatory. Currently false." }, "attribution_url": { "type": "string", "description": "FCCID.io link to use for optional attribution." } }, "description": "Usage rights for the calling account." } } }, "EanResolution": { "type": "object", "description": "EAN-to-FCC discovery only. Supporting product clues appear within FCC candidates, never as standalone barcode records.", "required": [ "gtin14", "status", "clue_source", "product_association" ], "properties": { "gtin14": { "type": "string", "pattern": "^[0-9]{14}$", "description": "Checksum-validated barcode normalized to a 14-digit string. Leading zeros are preserved." }, "status": { "enum": [ "fcc_candidates_found", "no_fcc_match" ], "description": "fcc_candidates_found or no_fcc_match." }, "clue_source": { "enum": [ "fcc_records", "request", "product_sources" ], "description": "fcc_records for a direct FCC association, request for caller-supplied clues, or product_sources for external product clues." }, "direct_record_matches": { "type": "integer", "minimum": 0, "maximum": 10, "description": "Number of returned FCC candidates with direct barcode evidence." }, "product_association": { "const": "unconfirmed", "description": "unconfirmed. Review whether the evidence applies to the specific product." } } }, "Screening": { "type": "object", "description": "Present on /validate only, after current publication policy. Supports evidence review; never a compliance clearance or live FCC EAS result.", "required": [ "schema_version", "assessed_at", "rules_reviewed_at", "marketing_eligibility", "review_required", "checks", "next_actions" ], "properties": { "schema_version": { "const": "1", "description": "Version of the screening object." }, "purpose": { "const": "us_marketplace_fcc_id_screening", "description": "Identifier for the US marketplace FCC ID screening workflow." }, "assessed_at": { "type": "string", "format": "date-time", "description": "UTC timestamp for this screening response." }, "rules_reviewed_at": { "type": "string", "format": "date", "description": "Date the published rule references were reviewed." }, "rules_url": { "type": "string", "format": "uri", "description": "Machine-readable rule references." }, "guide_url": { "type": "string", "format": "uri", "description": "FCCID.io guide to marketplace checks." }, "marketing_eligibility": { "const": "undetermined", "description": "undetermined. The response identifies checks that require additional evidence or listing context." }, "review_required": { "const": true, "description": "True when review is required." }, "checks": { "type": "object", "properties": { "fcc_id_record": { "type": "object", "properties": { "status": { "enum": [ "confirmed", "invalid_syntax", "unconfirmed" ], "description": "confirmed, invalid_syntax, or unconfirmed." }, "basis": { "type": "string", "description": "Source used for the record check." }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "description": "Evidence supporting the exact record check." } }, "description": "Exact FCC record check." }, "recorded_grant": { "type": "object", "properties": { "status": { "enum": [ "observed", "unknown" ], "description": "observed for a documented historical grant, otherwise unknown." }, "as_of": { "type": [ "string", "null" ], "description": "Historical grant date, or null." } }, "description": "Historical grant check." }, "product_association": { "type": "object", "properties": { "status": { "const": "not_verified", "description": "not_verified. Compare the product label and model with the returned evidence." } }, "description": "Evidence linking this physical product to the FCC ID." }, "current_authorization": { "type": "object", "properties": { "status": { "const": "unknown", "description": "unknown. Requires evidence of the current authorization and applicable restrictions." } }, "description": "Status of the current equipment authorization." }, "fcc_eas_live_check": { "type": "object", "properties": { "status": { "const": "not_performed", "description": "not_performed. Live official verification is a separate step." } }, "description": "Whether the API queried the official FCC EAS system live." }, "covered_equipment": { "type": "object", "properties": { "status": { "const": "not_assessed", "description": "not_assessed. Covered equipment review is a separate step." } }, "description": "Covered equipment review." }, "listing_display_requirement": { "type": "object", "properties": { "status": { "const": "requires_listing_context", "description": "requires_listing_context. Apply the requirements to the actual listing." } }, "description": "Whether the specific listing context has been assessed." }, "seller_accuracy_certification": { "type": "object", "properties": { "status": { "const": "not_collected", "description": "not_collected. The API collects no seller attestation." } }, "description": "Whether a seller certification was collected." }, "published_warnings": { "type": "object", "properties": { "status": { "enum": [ "review_items_found", "none_found_in_covered_sources" ], "description": "review_items_found or none_found_in_covered_sources." }, "count": { "type": "integer", "minimum": 0, "description": "Number of linked warning items in the response." }, "coverage": { "type": "string", "description": "Scope of the warning sources." } }, "description": "Warnings published in the covered sources." } }, "description": "Individual evidence and review checks." }, "next_actions": { "type": "array", "items": { "type": "string" }, "description": "Machine-readable codes for suggested review steps." }, "official_verification_url": { "type": "string", "format": "uri", "description": "Official FCC equipment authorization search." }, "limitations": { "type": "string", "description": "What additional checks or evidence are needed." } } }, "RateLimit": { "type": "object", "required": [ "limit", "remaining", "resets_at", "window_seconds" ], "properties": { "limit": { "type": "integer", "minimum": 1, "description": "Maximum requests allowed in the minute." }, "remaining": { "type": "integer", "minimum": 0, "description": "Requests still available in the minute." }, "resets_at": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp for the next minute boundary." }, "window_seconds": { "type": "integer", "const": 60, "description": "Length of the rate window in seconds. Currently 60." } } }, "Authorization": { "type": "object", "properties": { "status": { "enum": [ "granted", "denied", "dismissed", "unknown" ], "description": "granted if a historical grant is evidenced. denied or dismissed if an explicit decision exists and no grant is evidenced. unknown when the evidence is inconclusive." }, "as_of": { "type": [ "string", "null" ], "format": "date", "description": "Date of the historical grant or explicit decision, or null if unavailable. May be absent on malformed input." }, "evidence": { "type": "array", "items": { "type": "object", "properties": { "application_id": { "type": "string", "description": "FCC application to which the observation applies." }, "status": { "enum": [ "granted", "denied", "dismissed" ], "description": "granted, denied, or dismissed for this application observation." }, "date": { "type": [ "string", "null" ], "format": "date", "description": "Grant or decision date, or null if unavailable." }, "basis": { "enum": [ "grant_eas", "grant_tcb", "search", "notice" ], "description": "grant_eas or grant_tcb for a saved grant, search for a decision label in FCC search results, or notice for FCC correspondence." }, "observed_at": { "type": [ "string", "null" ], "format": "date-time", "description": "UTC observation timestamp, or null if the archive provides no observation time." }, "source_url": { "type": "string", "format": "uri", "description": "FCCID.io page for the underlying record." } } }, "description": "Application-level evidence behind the authorization result. A different application under the same FCC ID can have a different outcome." } } }, "Candidate": { "type": "object", "required": [ "fccid", "valid", "match", "evidence", "links" ], "properties": { "fccid": { "type": "string", "description": "Canonical FCC identifier recorded by FCCID.io." }, "valid": { "const": true, "description": "true confirms an FCC-sourced record, false indicates malformed syntax, and null means a plausible identifier was unconfirmed. For candidates, true refers to the record itself." }, "authorization": { "$ref": "#/components/schemas/Authorization", "description": "Historical FCC decision evidence. See the authorization fields below." }, "applicant": { "type": [ "string", "null" ], "description": "Name of the FCC applicant, or null if unavailable." }, "manufacturer": { "type": [ "string", "null" ], "description": "Identified manufacturer, or null if unavailable." }, "brand": { "type": [ "string", "null" ], "description": "Identified consumer brand, or null if unavailable." }, "models": { "type": "array", "items": { "type": "string" }, "description": "Model names recorded in the covered applications." }, "product": { "type": [ "string", "null" ], "description": "Equipment description, or null if unavailable." }, "match": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "identifier_match", "candidate" ], "description": "identifier_match for an exact identifier match or candidate for a search result that needs review." }, "method": { "type": "string", "description": "Selection method. exact_fccid, exact_ean_record, barcode_record, applicant_model, document_text, character_variant, or grantee_record." }, "reasons": { "type": "array", "items": { "type": "string" }, "description": "Human-readable explanations for the selection." } }, "description": "How this FCC record was selected." }, "evidence": { "type": "array", "items": { "$ref": "#/components/schemas/Evidence" }, "description": "Source records supporting the match. Fields vary by source kind." }, "links": { "type": "object", "properties": { "fccid": { "type": "string", "format": "uri", "description": "FCCID.io record page." }, "barcode": { "type": "string", "format": "uri", "description": "Barcode.report link when supporting barcode clues were used." } }, "description": "Relevant links for the record." }, "equipment_class": { "type": [ "string", "null" ], "description": "FCC equipment class code, or null if unavailable." }, "latest_filing_date": { "type": [ "string", "null" ], "description": "Latest final-action date found in the covered records, or null." }, "grantee_code": { "type": "string", "description": "Grantee associated with this candidate. Present on brand results." }, "news": { "type": "array", "items": { "$ref": "#/components/schemas/Article" }, "description": "Published articles linked to the FCC ID. An empty array means none were found in covered sources." }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/Article" }, "description": "Linked warnings, recalls or enforcement items in covered sources. An empty array means none were found there." } } }, "Frequency": { "type": "object", "required": [ "application_id", "lower_mhz", "upper_mhz", "source_url" ], "properties": { "application_id": { "type": "string", "description": "FCC application associated with this frequency range." }, "lower_mhz": { "type": "number", "description": "Lower frequency in MHz." }, "upper_mhz": { "type": "number", "description": "Upper frequency in MHz." }, "power_output": { "type": [ "string", "null" ], "description": "Output power as recorded by the source, or null." }, "power_output_unit": { "type": [ "string", "null" ], "description": "Source unit for output power when supplied. May be null or omitted." }, "emission_designator": { "type": [ "string", "null" ], "description": "FCC emission designator, or null." }, "rule_parts": { "type": [ "string", "null" ], "description": "Applicable FCC rule parts recorded for this range, or null." }, "grant_date": { "type": [ "string", "null" ], "description": "Date of the underlying historical grant, or null." }, "source_url": { "type": "string", "format": "uri", "description": "FCCID.io source for the range." } } }, "Error": { "type": "object", "required": [ "api_version", "request_id", "error" ], "properties": { "api_version": { "const": "1", "description": "Response contract version." }, "request_id": { "type": "string", "description": "Unique request identifier for support and diagnostics." }, "rate_limit": { "$ref": "#/components/schemas/RateLimit", "description": "Minute allowance snapshot when available. See the shared response fields." }, "error": { "type": "object", "required": [ "code", "message" ], "properties": { "code": { "type": "string", "description": "Machine-readable failure code. rate_limit is a minute limit, quota_exceeded is a monthly limit, and data_unavailable indicates the backing source could not complete the request." }, "message": { "type": "string", "description": "Human-readable message. Use error.code for application logic." } }, "description": "Error details. Use the HTTP status and error.code to decide what to do." } } }, "Evidence": { "type": "object", "properties": { "kind": { "enum": [ "fcc_application", "fcc_document", "fcc_ean_association", "ean_product_clue", "ean_fccid_reference" ], "description": "Source type. fcc_application, fcc_document, fcc_ean_association, ean_product_clue, or ean_fccid_reference." }, "application_id": { "type": "string", "description": "FCC application that the evidence concerns, when available." }, "document_id": { "type": "integer", "minimum": 0, "description": "FCC exhibit ID for document evidence." }, "barcode_id": { "type": "integer", "minimum": 0, "description": "FCCID.io identifier for the direct barcode record." }, "fccid": { "type": "string", "description": "FCC identifier attached to the direct association." }, "gtin14": { "type": "string", "description": "14-digit barcode attached to the evidence." }, "sha256": { "type": "string", "description": "SHA-256 digest of the supporting exhibit file." }, "title": { "type": [ "string", "null" ], "description": "Exhibit title or description, or null." }, "date": { "type": [ "string", "null" ], "description": "Source application final-action date, or null." }, "url": { "type": "string", "description": "Link to the FCCID.io application or exhibit." }, "source_url": { "type": [ "string", "null" ], "description": "Link to the source of the barcode or product clue." }, "observed_at": { "type": [ "string", "null" ], "description": "Source observation timestamp, or null when unavailable. Formatting can follow the source." }, "reference": { "type": "string", "description": "Opaque identifier for a published FCC barcode association." }, "brand": { "type": [ "string", "null" ], "description": "Brand reported by the product source, or null." }, "manufacturer": { "type": [ "string", "null" ], "description": "Manufacturer reported by the product source, or null." }, "model": { "type": "string", "description": "Model reported by the product source." } } }, "Article": { "type": "object", "properties": { "article_id": { "type": "integer", "minimum": 0, "description": "FCCID.io article identifier." }, "title": { "type": [ "string", "null" ], "description": "Headline, or null if unavailable." }, "date": { "type": [ "string", "null" ], "description": "Publication date, when available." }, "url": { "type": "string", "description": "FCCID.io article link." }, "source_url": { "type": [ "string", "null" ], "description": "Original publication link." }, "kind": { "type": "string", "description": "Published content type. Warnings can include warning, recall or enforcement." }, "association": { "type": "object", "properties": { "basis": { "type": "string", "description": "Basis for the link, such as exact_fccid." }, "fccid": { "type": "string", "description": "FCC identifier to which the article is linked." } }, "description": "Relationship used to attach the article to a record." } } }, "ServiceStatus": { "type": "object", "properties": { "api_version": { "const": "1", "description": "Response contract version. Currently 1." }, "status": { "enum": [ "operational", "degraded" ], "description": "operational when all probes pass or degraded when one or more services are unavailable. Both results use HTTP 200." }, "checked_at": { "type": "string", "format": "date-time", "description": "UTC timestamp when the component probes were assembled. The endpoint may return a response cached for 30 seconds." }, "services": { "type": "object", "properties": { "fccid_records": { "type": "object", "properties": { "name": { "type": "string", "description": "Human-readable component name when available." }, "status": { "enum": [ "operational", "unavailable" ], "description": "operational or unavailable for this component." }, "latest_filing_date": { "type": [ "string", "null" ], "description": "Latest final-action date observed in the backing FCC database, or null." } }, "description": "Backing FCC record database." }, "fccid_documents": { "type": "object", "properties": { "name": { "type": "string", "description": "Human-readable component name when available." }, "status": { "enum": [ "operational", "unavailable" ], "description": "operational or unavailable for this component." } }, "description": "FCC document search service." }, "barcode_ean": { "type": "object", "properties": { "name": { "type": "string", "description": "Human-readable component name when available." }, "status": { "enum": [ "operational", "unavailable" ], "description": "operational or unavailable for this component." }, "check": { "type": "string", "description": "Type of probe used for the barcode service when successful." }, "sample_observed_at": { "type": [ "string", "null" ], "description": "When the sample barcode data was observed by its source, or null." } }, "description": "Barcode.report product and barcode reader." } }, "description": "Component results keyed by fccid_records, fccid_documents and barcode_ean." } } } } } }