Every field. One reference.

The API, in detail.

Base URL: https://api.fccidapi.com

Send Authorization: Bearer YOUR_API_KEY on all data requests. Health checks are public. REST accepts API keys; OAuth access tokens are scoped toMCP.

Generated from the same Rust OpenAPI definitions as the service. The live specification describes the deployed version.

GET

/health/live

No query parameters.

Responses

200 · Response schema

application/json · Health

{
  "$ref": "#/components/schemas/Health"
}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/health/ready

No query parameters.

Responses

200 · Response schema

application/json · Health

{
  "$ref": "#/components/schemas/Health"
}
503 · Response schema

application/json · Health

{
  "$ref": "#/components/schemas/Health"
}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/applications/{id}

ParameterType / locationDescription
id
Required
string
path
See schema for accepted values.

Responses

200 · Response schema

application/json · Application

{
  "$ref": "#/components/schemas/Application"
}
404 · Application not collected

No response body.

409 · Source detail requires review

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/brand

ParameterType / locationDescription
brand
Optional
string
query
See schema for accepted values.
q
Optional
string
query
See schema for accepted values.
grantee_code
Optional
string
query
See schema for accepted values.

Responses

200 · Response schema

application/json · object

{}
400 · brand, q or grantee_code required

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

POST

/v1/bulk

No query parameters.

JSON request body

Schema: BulkInput

{
  "$ref": "#/components/schemas/BulkInput"
}

Responses

200 · Response schema

application/json · BulkOutput

{
  "$ref": "#/components/schemas/BulkOutput"
}
400 · Response schema

application/json · ErrorBody

{
  "$ref": "#/components/schemas/ErrorBody"
}
429 · Response schema

application/json · ErrorBody

{
  "$ref": "#/components/schemas/ErrorBody"
}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/coverage

No query parameters.

Responses

200 · Local corpus counts and recent import receipts; no completeness claim

application/json · object

{}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/exhibits/{id}

ParameterType / locationDescription
id
Required
string
path
See schema for accepted values.

Responses

200 · Response schema

application/json · object

{}
404 · Not in collected metadata

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/fccid/{id}

ParameterType / locationDescription
id
Required
string
path
FCC ID
fccid
Optional
string
query
Exact FCC ID; punctuation is preserved.
q
Optional
string
query
Substring of FCC ID, applicant name or collected product description.
grantee
Optional
string
query
See schema for accepted values.
country
Optional
string
query
See schema for accepted values.
equipment_class
Optional
string
query
See schema for accepted values.
grant_status
Optional
string
query
EAS observation: granted, not_granted or unknown; not a compliance verdict.
has_details
Optional
boolean
query
Restrict to applications with (or without) collected detail pages.
needs_refresh
Optional
boolean
query
Missing details, an older projection, source change, or scheduled refresh due.
refresh_priority
Optional
boolean
query
Queue-only priority ordering; incompatible with cursor pagination.
from_date
Optional
string
query
See schema for accepted values.
to_date
Optional
string
query
See schema for accepted values.
lower_mhz
Optional
number
query
Frequency overlap in MHz; both bounds required.
upper_mhz
Optional
number
query
See schema for accepted values.
cursor
Optional
string
query
Last application source ID from next_cursor. URL-encode it as a query value.
limit
Optional
integer
query
Default 25, maximum 100 applications.

Responses

200 · Response schema

application/json · Page

{
  "$ref": "#/components/schemas/Page"
}
404 · Not in the local corpus; not an FCC invalidity verdict

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/fccid/{id}/exhibits

ParameterType / locationDescription
id
Required
string
path
See schema for accepted values.
fccid
Optional
string
query
Exact FCC ID; punctuation is preserved.
q
Optional
string
query
Substring of FCC ID, applicant name or collected product description.
grantee
Optional
string
query
See schema for accepted values.
country
Optional
string
query
See schema for accepted values.
equipment_class
Optional
string
query
See schema for accepted values.
grant_status
Optional
string
query
EAS observation: granted, not_granted or unknown; not a compliance verdict.
has_details
Optional
boolean
query
Restrict to applications with (or without) collected detail pages.
needs_refresh
Optional
boolean
query
Missing details, an older projection, source change, or scheduled refresh due.
refresh_priority
Optional
boolean
query
Queue-only priority ordering; incompatible with cursor pagination.
from_date
Optional
string
query
See schema for accepted values.
to_date
Optional
string
query
See schema for accepted values.
lower_mhz
Optional
number
query
Frequency overlap in MHz; both bounds required.
upper_mhz
Optional
number
query
See schema for accepted values.
cursor
Optional
string
query
Last application source ID from next_cursor. URL-encode it as a query value.
limit
Optional
integer
query
Default 25, maximum 100 applications.

Responses

200 · Exhibit lists grouped by application with explicit collection status

application/json · object

{}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/frequency

ParameterType / locationDescription
fccid
Optional
string
query
Exact FCC ID; punctuation is preserved.
q
Optional
string
query
Substring of FCC ID, applicant name or collected product description.
grantee
Optional
string
query
See schema for accepted values.
country
Optional
string
query
See schema for accepted values.
equipment_class
Optional
string
query
See schema for accepted values.
grant_status
Optional
string
query
EAS observation: granted, not_granted or unknown; not a compliance verdict.
has_details
Optional
boolean
query
Restrict to applications with (or without) collected detail pages.
needs_refresh
Optional
boolean
query
Missing details, an older projection, source change, or scheduled refresh due.
refresh_priority
Optional
boolean
query
Queue-only priority ordering; incompatible with cursor pagination.
from_date
Optional
string
query
See schema for accepted values.
to_date
Optional
string
query
See schema for accepted values.
lower_mhz
Optional
number
query
Frequency overlap in MHz; both bounds required.
upper_mhz
Optional
number
query
See schema for accepted values.
cursor
Optional
string
query
Last application source ID from next_cursor. URL-encode it as a query value.
limit
Optional
integer
query
Default 25, maximum 100 applications.

Responses

200 · Response schema

application/json · object

{}
400 · FCC ID or frequency bounds required

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/grantees

ParameterType / locationDescription
q
Optional
string
query
See schema for accepted values.
cursor
Optional
string
query
See schema for accepted values.
limit
Optional
integer
query
See schema for accepted values.

Responses

200 · Historical registry with keyset pagination

application/json · object

{}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/grantees/{code}

ParameterType / locationDescription
code
Required
string
path
See schema for accepted values.
fccid
Optional
string
query
Exact FCC ID; punctuation is preserved.
q
Optional
string
query
Substring of FCC ID, applicant name or collected product description.
grantee
Optional
string
query
See schema for accepted values.
country
Optional
string
query
See schema for accepted values.
equipment_class
Optional
string
query
See schema for accepted values.
grant_status
Optional
string
query
EAS observation: granted, not_granted or unknown; not a compliance verdict.
has_details
Optional
boolean
query
Restrict to applications with (or without) collected detail pages.
needs_refresh
Optional
boolean
query
Missing details, an older projection, source change, or scheduled refresh due.
refresh_priority
Optional
boolean
query
Queue-only priority ordering; incompatible with cursor pagination.
from_date
Optional
string
query
See schema for accepted values.
to_date
Optional
string
query
See schema for accepted values.
lower_mhz
Optional
number
query
Frequency overlap in MHz; both bounds required.
upper_mhz
Optional
number
query
See schema for accepted values.
cursor
Optional
string
query
Last application source ID from next_cursor. URL-encode it as a query value.
limit
Optional
integer
query
Default 25, maximum 100 applications.

Responses

200 · Historical registry plus collected applications

application/json · object

{}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/lookup

ParameterType / locationDescription
fccid
Optional
string
query
See schema for accepted values.
q
Optional
string
query
See schema for accepted values.
brand
Optional
string
query
See schema for accepted values.
manufacturer
Optional
string
query
See schema for accepted values.
model
Optional
string
query
See schema for accepted values.
limit
Optional
integer
query
See schema for accepted values.

Responses

200 · Response schema

application/json · object

{}
400 · Invalid matching query

No response body.

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

GET

/v1/validate

ParameterType / locationDescription
fccid
Required
string
query
See schema for accepted values.

Responses

200 · Response schema

application/json · Validation

{
  "$ref": "#/components/schemas/Validation"
}

Data requests can also return authentication, quota, or service errors. Error handling and retry guidance →

Data schemas

Optional fields may be absent. Nullable fields may be null. Preserve missing values; do not turn them into inferred facts.

Application
FieldTypeMeaning
action_date
Required
string—
applicant_name
Optional
string | null—
country
Optional
string | null—
details
Optional
object—
evidence
Required
array<Evidence>—
exhibits_url
Required
string—
fcc_id
Required
string—
form_url
Required
string—
frequencies
Required
array<Frequency>—
grant_status
Required
string—
grant_url
Optional
string | null—
grantee_code
Required
string—
product_code
Required
string—
profile
Required
Profile—
purpose
Optional
string | null—
source_id
Required
string—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "action_date": {
      "format": "date",
      "type": "string"
    },
    "applicant_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "details": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/components/schemas/Details",
          "description": "None means not collected; Some with zero exhibits means a fetched empty public list."
        }
      ]
    },
    "evidence": {
      "items": {
        "$ref": "#/components/schemas/Evidence"
      },
      "type": "array"
    },
    "exhibits_url": {
      "type": "string"
    },
    "fcc_id": {
      "type": "string"
    },
    "form_url": {
      "type": "string"
    },
    "frequencies": {
      "items": {
        "$ref": "#/components/schemas/Frequency"
      },
      "type": "array"
    },
    "grant_status": {
      "type": "string"
    },
    "grant_url": {
      "type": [
        "string",
        "null"
      ]
    },
    "grantee_code": {
      "type": "string"
    },
    "product_code": {
      "type": "string"
    },
    "profile": {
      "$ref": "#/components/schemas/Profile"
    },
    "purpose": {
      "type": [
        "string",
        "null"
      ]
    },
    "source_id": {
      "type": "string"
    }
  },
  "required": [
    "source_id",
    "fcc_id",
    "grantee_code",
    "product_code",
    "action_date",
    "grant_status",
    "profile",
    "form_url",
    "exhibits_url",
    "frequencies",
    "evidence"
  ],
  "type": "object"
}
BulkApplication
FieldTypeMeaning
action_date
Required
string—
applicant_name
Optional
string | null—
country
Optional
string | null—
equipment_class
Optional
string | null—
fcc_id
Required
string—
grant_status
Required
string—
has_details
Required
boolean—
held_for_review
Required
boolean—
source_id
Required
string—
source_url
Optional
string | null—
Raw JSON schema
{
  "properties": {
    "action_date": {
      "format": "date",
      "type": "string"
    },
    "applicant_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "equipment_class": {
      "type": [
        "string",
        "null"
      ]
    },
    "fcc_id": {
      "type": "string"
    },
    "grant_status": {
      "type": "string"
    },
    "has_details": {
      "type": "boolean"
    },
    "held_for_review": {
      "type": "boolean"
    },
    "source_id": {
      "type": "string"
    },
    "source_url": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "source_id",
    "fcc_id",
    "action_date",
    "grant_status",
    "has_details",
    "held_for_review"
  ],
  "type": "object"
}
BulkInput
FieldTypeMeaning
fcc_ids
Required
array<string>1–5 distinct IDs on Free, 1–100 on paid plans. Each ID costs one API unit.
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "fcc_ids": {
      "description": "1–5 distinct IDs on Free, 1–100 on paid plans. Each ID costs one API unit.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "fcc_ids"
  ],
  "type": "object"
}
BulkMatch
FieldTypeMeaning
applications
Required
array<BulkApplication>—
fcc_id
Required
string—
status
Required
stringfound or not_in_collected_corpus; never an FCC validity determination.
truncated
Required
booleanAt most ten recent applications per ID. Follow /v1/search?fccid=... for more.
Raw JSON schema
{
  "properties": {
    "applications": {
      "items": {
        "$ref": "#/components/schemas/BulkApplication"
      },
      "type": "array"
    },
    "fcc_id": {
      "type": "string"
    },
    "status": {
      "description": "found or not_in_collected_corpus; never an FCC validity determination.",
      "type": "string"
    },
    "truncated": {
      "description": "At most ten recent applications per ID. Follow /v1/search?fccid=... for more.",
      "type": "boolean"
    }
  },
  "required": [
    "fcc_id",
    "status",
    "applications",
    "truncated"
  ],
  "type": "object"
}
BulkOutput
FieldTypeMeaning
corpus_scope
Required
string—
csv
Optional
string | null—
results
Required
array<BulkMatch>—
units
Required
integer—
Raw JSON schema
{
  "properties": {
    "corpus_scope": {
      "type": "string"
    },
    "csv": {
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "items": {
        "$ref": "#/components/schemas/BulkMatch"
      },
      "type": "array"
    },
    "units": {
      "format": "int32",
      "type": "integer"
    }
  },
  "required": [
    "results",
    "units",
    "corpus_scope"
  ],
  "type": "object"
}
DetailFailure
FieldTypeMeaning
attempted_at
Required
string—
http_status
Required
integer—
prior_receipt_sha256
Required
string—
reason
Required
string—
receipt_sha256
Required
string—
review_required
Required
boolean—
schema_version
Required
integer—
source_url
Required
string—
Raw JSON schema
{
  "properties": {
    "attempted_at": {
      "format": "date-time",
      "type": "string"
    },
    "http_status": {
      "format": "int32",
      "minimum": 0,
      "type": "integer"
    },
    "prior_receipt_sha256": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    },
    "receipt_sha256": {
      "type": "string"
    },
    "review_required": {
      "type": "boolean"
    },
    "schema_version": {
      "format": "int32",
      "type": "integer"
    },
    "source_url": {
      "type": "string"
    }
  },
  "required": [
    "schema_version",
    "http_status",
    "attempted_at",
    "source_url",
    "receipt_sha256",
    "prior_receipt_sha256",
    "review_required",
    "reason"
  ],
  "type": "object"
}
DetailHold
FieldTypeMeaning
failure
Required
DetailFailure—
fcc_id
Required
string—
held_at
Required
string—
source_id
Required
string—
Raw JSON schema
{
  "properties": {
    "failure": {
      "$ref": "#/components/schemas/DetailFailure"
    },
    "fcc_id": {
      "type": "string"
    },
    "held_at": {
      "format": "date-time",
      "type": "string"
    },
    "source_id": {
      "type": "string"
    }
  },
  "required": [
    "source_id",
    "fcc_id",
    "held_at",
    "failure"
  ],
  "type": "object"
}
Details
FieldTypeMeaning
composite_device
Optional
boolean | null—
confidentiality_release_date
Optional
string | null—
description
Optional
string | null—
equipment_class
Optional
string | null—
evidence
Required
array<Evidence>—
exhibits
Required
array<Exhibit>—
frn
Optional
string | null—
grant_note_blocks
Optional
array<string>Distinct source note blocks in document order when no single note can be selected. Presence means grant_notes is null; blocks are not merged or interpreted as current conditions.
grant_notes
Optional
string | null—
models
Optional
array<string>—
modular_type
Optional
string | null—
schema_version
Optional
integer—
short_term_confidential
Optional
boolean | null—
tcb_scope
Optional
string | null—
technical
Required
array<Technical>—
test_firm_name
Optional
string | null—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "composite_device": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "confidentiality_release_date": {
      "format": "date",
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "equipment_class": {
      "type": [
        "string",
        "null"
      ]
    },
    "evidence": {
      "items": {
        "$ref": "#/components/schemas/Evidence"
      },
      "type": "array"
    },
    "exhibits": {
      "items": {
        "$ref": "#/components/schemas/Exhibit"
      },
      "type": "array"
    },
    "frn": {
      "type": [
        "string",
        "null"
      ]
    },
    "grant_note_blocks": {
      "description": "Distinct source note blocks in document order when no single note can be selected.\nPresence means grant_notes is null; blocks are not merged or interpreted as current conditions.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "grant_notes": {
      "type": [
        "string",
        "null"
      ]
    },
    "models": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "modular_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "schema_version": {
      "format": "int32",
      "type": "integer"
    },
    "short_term_confidential": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "tcb_scope": {
      "type": [
        "string",
        "null"
      ]
    },
    "technical": {
      "items": {
        "$ref": "#/components/schemas/Technical"
      },
      "type": "array"
    },
    "test_firm_name": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "technical",
    "exhibits",
    "evidence"
  ],
  "type": "object"
}
ErrorBody
FieldTypeMeaning
error
Required
string—
Raw JSON schema
{
  "properties": {
    "error": {
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}
Evidence
FieldTypeMeaning
observed_at
Required
string—
representation
Required
string—
sha256
Required
string—
url
Required
string—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "observed_at": {
      "format": "date-time",
      "type": "string"
    },
    "representation": {
      "type": "string"
    },
    "sha256": {
      "type": "string"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "url",
    "sha256",
    "observed_at",
    "representation"
  ],
  "type": "object"
}
Exhibit
FieldTypeMeaning
attachment_id
Required
string—
available_date
Optional
string | null—
exhibit_type
Optional
string | null—
file_type
Optional
string | null—
submitted_date
Optional
string | null—
title
Optional
string | null—
url
Required
string—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "attachment_id": {
      "type": "string"
    },
    "available_date": {
      "format": "date",
      "type": [
        "string",
        "null"
      ]
    },
    "exhibit_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "file_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "submitted_date": {
      "format": "date",
      "type": [
        "string",
        "null"
      ]
    },
    "title": {
      "type": [
        "string",
        "null"
      ]
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "attachment_id",
    "url"
  ],
  "type": "object"
}
Frequency
FieldTypeMeaning
lower_mhz
Optional
number | null—
upper_mhz
Optional
number | null—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "lower_mhz": {
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    },
    "upper_mhz": {
      "format": "double",
      "type": [
        "number",
        "null"
      ]
    }
  },
  "type": "object"
}
Health
FieldTypeMeaning
status
Required
string—
Raw JSON schema
{
  "properties": {
    "status": {
      "type": "string"
    }
  },
  "required": [
    "status"
  ],
  "type": "object"
}
Page
FieldTypeMeaning
applications
Required
array<Application>—
corpus_scope
Required
string—
count
Required
integer—
detail_holds
Required
array<DetailHold>—
next_cursor
Optional
string | null—
Raw JSON schema
{
  "properties": {
    "applications": {
      "items": {
        "$ref": "#/components/schemas/Application"
      },
      "type": "array"
    },
    "corpus_scope": {
      "type": "string"
    },
    "count": {
      "minimum": 0,
      "type": "integer"
    },
    "detail_holds": {
      "items": {
        "$ref": "#/components/schemas/DetailHold"
      },
      "type": "array"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "detail_holds",
    "applications",
    "count",
    "corpus_scope"
  ],
  "type": "object"
}
Profile
FieldTypeMeaning
address
Optional
string | null—
city
Optional
string | null—
postal_code
Optional
string | null—
state
Optional
string | null—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "address": {
      "type": [
        "string",
        "null"
      ]
    },
    "city": {
      "type": [
        "string",
        "null"
      ]
    },
    "postal_code": {
      "type": [
        "string",
        "null"
      ]
    },
    "state": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}
Technical
FieldTypeMeaning
emission_designator
Optional
string | null—
frequency_range_mhz
Optional
string | null—
frequency_tolerance
Optional
string | null—
note_codes
Optional
string | null—
output_watts
Optional
string | null—
rule_parts
Optional
string | null—
Raw JSON schema
{
  "additionalProperties": false,
  "properties": {
    "emission_designator": {
      "type": [
        "string",
        "null"
      ]
    },
    "frequency_range_mhz": {
      "type": [
        "string",
        "null"
      ]
    },
    "frequency_tolerance": {
      "type": [
        "string",
        "null"
      ]
    },
    "note_codes": {
      "type": [
        "string",
        "null"
      ]
    },
    "output_watts": {
      "type": [
        "string",
        "null"
      ]
    },
    "rule_parts": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}
Validation
FieldTypeMeaning
authorization
Required
string—
corpus_scope
Required
string—
covered_equipment
Required
string—
fcc_id
Required
string—
live_fcc_check
Required
boolean—
marketing_eligibility
Required
stringDeliberately never inferred from a partial corpus or a stale grant.
record_found
Required
boolean—
syntax_valid
Required
boolean—
Raw JSON schema
{
  "properties": {
    "authorization": {
      "type": "string"
    },
    "corpus_scope": {
      "type": "string"
    },
    "covered_equipment": {
      "type": "string"
    },
    "fcc_id": {
      "type": "string"
    },
    "live_fcc_check": {
      "type": "boolean"
    },
    "marketing_eligibility": {
      "description": "Deliberately never inferred from a partial corpus or a stale grant.",
      "type": "string"
    },
    "record_found": {
      "type": "boolean"
    },
    "syntax_valid": {
      "type": "boolean"
    }
  },
  "required": [
    "fcc_id",
    "syntax_valid",
    "record_found",
    "authorization",
    "marketing_eligibility",
    "covered_equipment",
    "live_fcc_check",
    "corpus_scope"
  ],
  "type": "object"
}