{
  "anchors": [
    {
      "about": "2-letter state/jurisdiction code (PD-003).",
      "format": "usps_state",
      "kind": "geography",
      "name": "state",
      "scope": "universal"
    }
  ],
  "capability": "space.satellite_filings",
  "codebooks": {
    "app_type_code": {
      "codes": {
        "A/O": {
          "label": "Authorization to Operate"
        },
        "AMD": {
          "label": "Amendment"
        },
        "ASG": {
          "label": "Assignment"
        },
        "L/A": {
          "label": "Launch Authority"
        },
        "LOA": {
          "label": "Launch and Operating Authority"
        },
        "MOD": {
          "label": "Modification"
        },
        "PDR": {
          "label": "Petition for Declaratory Ruling"
        },
        "PPL": {
          "label": "Petition for Declaratory Ruling to be Added to the Permitted List"
        },
        "RPL": {
          "label": "Replacement Satellite Application (no new frequencies)"
        },
        "STA": {
          "label": "Special Temporary Authority"
        },
        "T/C": {
          "label": "Transfer of Control"
        },
        "WAV": {
          "label": "Waiver"
        }
      },
      "coverage": "every SAT application type the FCC defines",
      "note": "Verbatim FCC codes; the served app_type_text is the FCC's own decode from the same capture vintage. LOA (Launch and Operating Authority) is a new satellite system's operating application; STA is temporary authority; MOD modifies a grant.",
      "semantics": "fcc_ibfs_application_type",
      "source": "FCC IBFS app_typ_code.dat (SAT subsystem), the FCC's own table in the same dump."
    },
    "status_code": {
      "codes": {
        "A/C": {
          "label": "Action Complete"
        },
        "AFPN": {
          "label": "Accepted for Filing Public Notice"
        },
        "ATPN": {
          "label": "Action Taken Public Notice"
        },
        "COR": {
          "label": "Administrative Correction"
        },
        "FAFV": {
          "label": "Filed - awaiting fee verification"
        },
        "FNRQD": {
          "label": "Filed - fee not required"
        },
        "FPRVD": {
          "label": "Filed - payment received"
        },
        "UNBLK": {
          "label": "Unblocked"
        }
      },
      "coverage": "the FCC's full filing-status vocabulary",
      "note": "Verbatim FCC codes; the served status_text is the FCC's own decode from the same capture vintage. The dominant terminal statuses on the SAT docket are A/C (Action Complete) and ATPN (Action Taken Public Notice); AFPN (Accepted for Filing Public Notice) marks a filing in process.",
      "semantics": "fcc_ibfs_filing_status",
      "source": "FCC IBFS status_code.dat, the FCC's own table in the same dump."
    }
  },
  "data_point": {
    "does_not_answer": [
      "filings SUBMITTED to the FCC after the ICFS cutover (~mid-2025) \u2014 the FCC moved new-filing intake to ICFS, which publishes no bulk data; this source's new-filing intake structurally ends there (status updates on existing filings continue daily) \u2014 PD-064",
      "satellites in orbit or an orbital catalog (Space-Track is non-redistributable and refused; a filing is an authorization event, not a spacecraft)",
      "launch activity or launch counts (the FAA surface is its own planned block)",
      "a satellite count (one NGSO authorization can cover thousands of satellites; filings are never a proxy for fleet size)",
      "the satellite's location (state/city are the APPLICANT's mailing address, labeled applicant_*; satellites are not in states)",
      "earth-station (SES), telecom-carrier (ITC/214), or any non-SAT IBFS docket \u2014 out of scope for this block",
      "frequency assignments / technical spectrum parameters (the dump's engineering tables are not served in v1)",
      "whether a granted system is built, launched, or operating"
    ],
    "grain": "filing",
    "id": "space.satellite_filings",
    "note": "This is the FCC satellite LICENSING DOCKET \u2014 every space-station (SAT) filing in the FCC's own daily IBFS database dump, back to the 1960s, with the FCC's verbatim status/application-type codes and their same-vintage decode text. THE ENGRAVED BOUNDARY: new-filing intake into IBFS structurally ended at the FCC's ICFS cutover (~mid-2025) and ICFS publishes no bulk data, so filings SUBMITTED after the cutover are not here (status updates on existing filings continue daily). A filing is an authorization event \u2014 never a satellite count, an orbital catalog, or launch activity. state/city are the APPLICANT's mailing address, not the satellite's location.",
    "product_spec": "blocks/space_satellite_filings/card.md",
    "represented_fact": "The FCC satellite licensing docket \u2014 every space-station (SAT-subsystem) filing in the FCC's International Bureau Filing System, served as-reported from the FCC's own daily bulk database dump, one record per filing. Each filing carries the FCC's public filing key (`file_number`, e.g. SATLOA2025061800149), the call sign, the application type and status in the FCC's OWN vocabulary (verbatim codes plus the FCC's own decode text from the code tables inside the SAME dump vintage \u2014 never re-labeled), the full lifecycle date family (filed / grant / deny / dismiss / surrender / begin / expire / last-update / status-date), the FCC's plain-English filing description, and the applicant identity joined by the source's own address_key (name, DBA, city, state, zip, country \u2014 the APPLICANT's mailing address, labeled as such; satellites are not in states). The docket reaches back to the 1960s in every capture, and status/action updates on existing filings continue to flow daily. THE ENGRAVED BOUNDARY (PD-064): new-filing intake into IBFS structurally ENDED at the FCC's ICFS system cutover (~mid-2025; measured: zero 2026 filings while 2026-dated status actions continue) and the successor ICFS system publishes no bulk artifact \u2014 so filings SUBMITTED after the cutover are not in this source. That truncation is a property of the source, stated here and in the tool copy, never papered over. One authorization can cover thousands of satellites (NGSO systems); filings are filings, never a satellite count, never an orbital catalog, never launch activity. The event period is date_filed; on the one observed source-typo row (a year-4017 date_filed) it falls back to the FCC's receipt-date stamp embedded in the file number itself, with the provenance labeled (report_period_source). History accrues forward from daily captures (the FCC keeps no public per-vintage archive).",
    "source_basis": [
      "space.fcc.ibfs_sat"
    ],
    "source_decisions": [
      "docs/sources/space/fcc_ibfs/build-plan.md"
    ]
  },
  "input": {
    "controls": [
      "include_records",
      "include_evidence",
      "limit",
      "order_by",
      "top_n",
      "order",
      "rollup_other"
    ],
    "date_range_params": [
      "report_period_from",
      "report_period_to",
      "date_grant_from",
      "date_grant_to",
      "date_expire_from",
      "date_expire_to"
    ],
    "date_ranges": [
      "report_period",
      "date_grant",
      "date_expire"
    ],
    "field_metadata": {
      "applicant_state": {
        "answer_label": "applicant address state",
        "counting_definition": "An address label, not a number; group by `state` for the validated anchor.",
        "definition": "The APPLICANT's mailing address state as the FCC recorded it \u2014 never the satellite's location (satellites are not in states). The canonical `state` anchor carries the USPS-validated value; blanks (the FCC's shape for foreign applicants) are null.",
        "semantics": "fcc_ibfs_address_state_verbatim",
        "source_field": "applicant_state"
      },
      "description": {
        "answer_label": "FCC filing description",
        "counting_definition": "Free text, never aggregated.",
        "definition": "The FCC's own plain-English description of the filing, verbatim (e.g. the mission or request text the applicant filed). Served on DETAIL records.",
        "semantics": "fcc_ibfs_filing_description_verbatim",
        "source_field": "description"
      },
      "report_period_source": {
        "answer_label": "event-period provenance",
        "counting_definition": "A provenance label, not a number \u2014 it qualifies report_period; never aggregated.",
        "definition": "'date_filed' for every filing whose date_filed cell parses; 'file_number' on the one observed source-typo row (a year-4017 date_filed), where the event period comes from the FCC's receipt-date stamp embedded in the file number itself (PD-064). Served on DETAIL records.",
        "semantics": "pd064_event_period_provenance",
        "source_field": "report_period_source"
      }
    },
    "filters": [
      "as_of",
      "file_number",
      "callsign",
      "status_code",
      "app_type_code",
      "state",
      "applicant_name",
      "applicant_country",
      "report_period",
      "date_grant",
      "date_expire"
    ],
    "group_by": [
      "status_code",
      "app_type_code",
      "state",
      "applicant_name",
      "applicant_country"
    ],
    "ranking": {
      "no_ranking": "Omit order_by and top_n to return all groups in group-key order.",
      "order": {
        "default": "desc",
        "valid_values": [
          "desc",
          "asc"
        ]
      },
      "order_by": {
        "accepts": "one of output.metrics",
        "note": "Ranks the groups by a metric (a measure). Not a group_by dimension \u2014 rows already come back grouped by each group_by field.",
        "requires": [
          "group_by"
        ],
        "valid_values": [
          "source_record_count"
        ]
      },
      "top_n": {
        "note": "Keeps the top N groups by order_by; the rest fold into one (other) remainder (additive metrics sum into it, non-additive ones are nulled) so the result still reconciles to summary.totals.",
        "requires": [
          "group_by",
          "order_by"
        ],
        "type": "positive integer"
      }
    }
  },
  "output": {
    "aggregate_citation_fields": [
      "source_id",
      "publisher",
      "source_url",
      "source_file",
      "raw_file_sha256",
      "as_of",
      "source_rows_count",
      "source_rows_sample",
      "verify",
      "lineage_filter"
    ],
    "citation_fields": [
      "source_id",
      "source_url",
      "source_file",
      "sheet",
      "source_row",
      "file_number",
      "raw_file_sha256",
      "as_of"
    ],
    "detail_fields": [
      "source_id",
      "file_number",
      "source_record_key",
      "filing_key",
      "callsign",
      "subsystem_code",
      "status_code",
      "status_text",
      "last_action_code",
      "app_type_code",
      "app_type_text",
      "description",
      "address_key_raw",
      "applicant_name",
      "applicant_dba_name",
      "applicant_city",
      "applicant_state",
      "applicant_zip",
      "applicant_country",
      "state",
      "report_period_source",
      "applicant_unresolved",
      "status_date",
      "last_action_date",
      "date_filed",
      "date_grant",
      "date_deny",
      "date_dismiss",
      "date_surrender",
      "date_begin",
      "date_expire",
      "date_last_update",
      "report_period",
      "source_row_number",
      "as_of",
      "raw_file_sha256",
      "citation"
    ],
    "metric_groups": {
      "records": [
        "source_record_count"
      ]
    },
    "metric_metadata": {
      "source_record_count": {
        "additive_across_groups": true,
        "aggregation": "count source records",
        "authoritative_total_path": "summary.totals.source_record_count",
        "category": "records",
        "definition": "Count of FCC space-station (SAT) docket filings in the current result scope. A filing is an authorization EVENT \u2014 never a satellite count (one NGSO grant can cover thousands of satellites).",
        "description": "Number of FCC SAT docket filings contributing to the value. Counts near or after 2025 UNDERCOUNT new filing activity: new-filing intake into IBFS structurally ended at the FCC's ICFS cutover (~mid-2025) \u2014 the response's icfs_cutover note carries the boundary.",
        "display_name": "Filing count",
        "display_precision": "Integer.",
        "grain": "filing",
        "null_handling": "Always an integer count. An empty scope is zero filings in scope \u2014 not a measured zero.",
        "rollup_behavior": "additive_partition_metric",
        "row_metric_path": "rows[].metrics.source_record_count",
        "source_fields": [
          "source_record_key"
        ],
        "unit": "count"
      }
    },
    "metrics": [
      "source_record_count"
    ],
    "summary_fields": [
      "group_count",
      "totals"
    ]
  },
  "primitive": "query_space_satellite_filings_v1",
  "status": "available"
}
