{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/epa/refs/heads/main/json-schema/cam-facilities-facility-attributes-dto-schema.json",
  "title": "FacilityAttributesDTO",
  "description": "FacilityAttributesDTO schema from Facilities Management OpenAPI Specification",
  "type": "object",
  "properties": {
    "stateCode": {
      "type": "string",
      "description": "Two letter abbreviation for the State.",
      "example": "AK"
    },
    "facilityName": {
      "type": "string",
      "description": "The name given by the owners and operators to a facility",
      "example": "Barry"
    },
    "facilityId": {
      "type": "number",
      "description": "The Facility ID code assigned by the Department of Energy's Energy Information Administration. The Energy Information Administration Plant ID code is also referred to as the \"ORIS code\", \"ORISPL code\", \"Facility ID\", or \"Facility code\", among other names. If a Plant ID code has not been assigned by the Department of Energy's Energy Information Administration, then plant code means a code beginning with \"88\" assigned by the EPA's Clean Air Markets Division for electronic reporting.",
      "example": 3
    },
    "unitId": {
      "type": "string",
      "description": "Unique identifier for each unit at a facility.",
      "example": 5
    },
    "associatedStacks": {
      "type": "string",
      "description": "Stacks associated with the unit.",
      "example": "CS001"
    },
    "year": {
      "type": "number",
      "description": "The calendar year during which activity occurred.",
      "example": 2020
    },
    "programCodeInfo": {
      "type": "string",
      "description": "Statutory or regulatory based options for tracking and reducing air pollution emissions.",
      "example": "ARP,CSNOX,CSSO2G2,MATS"
    },
    "primaryRepInfo": {
      "type": "string",
      "description": "Unique identifier(s) for the primary representative(s) at a facility",
      "example": 17364
    },
    "epaRegion": {
      "type": "number",
      "description": "An EPA Region is a group of U.S. states. EPA Regions are numbered from 1 to 10 and each state belongs to one and only one EPA Region.",
      "example": 5
    },
    "nercRegion": {
      "type": "string",
      "description": "The North American Electric Reliability Corporation region in which the facility is located.",
      "example": "Mid-Continent Area Power Pool"
    },
    "county": {
      "type": "string",
      "description": "The county within a state in which a unit is operating.",
      "example": "Sherburne County"
    },
    "countyCode": {
      "type": "string",
      "description": "The numerical code identifying a specific county in a single state.",
      "example": "MN141"
    },
    "fipsCode": {
      "type": "string",
      "description": "The Federal Information Processing Standards (FIPS) Code of the facility, issued by the National Institute of Standards and Technology, which ensures uniform identification of geographic entities throughout all federal agencies.",
      "example": 141
    },
    "sourceCategory": {
      "type": "string",
      "description": "Description of a unit that classifies it in terms of the primary function of the unit.",
      "example": "Electric Utility"
    },
    "latitude": {
      "type": "number",
      "description": "Represents the physical latitude of the facility.",
      "example": 45.3792
    },
    "longitude": {
      "type": "number",
      "description": "Represents the physical longitude of the facility.",
      "example": -93.8958
    },
    "ownerOperator": {
      "type": "string",
      "description": "The name of any company that owns an allowance account or an affected unit.The name of any company that operates an affected unit.",
      "example": "Alabama Power Company (Operator)|Alabama Power Company (Owner)"
    },
    "so2Phase": {
      "type": "string",
      "description": "Title IV of the Clean Air Act SO2 Phase. Phase I started in 1995; Phase II started in 2000.",
      "example": "Phase 2"
    },
    "noxPhase": {
      "type": "string",
      "description": "The classification of an ARP unit that is subject to an ARP NOx emission rate limit (40 CFR Part 76). The unit is first classified by ARP Phase (Phase 1 or Phase 2) and then the unit (boiler) type is used to determine whether the unit is a Group 1 or Group 2 boiler.  This ARP Phase/Group classification then determines the standard NOx emission rate applicable to the unit.  This information is then used in determining ARP NOx compliance, depending on the compliance approach (standard NOx limit or averaging plan) selected for the unit.",
      "example": "Phase 1 Group 1"
    },
    "unitType": {
      "type": "string",
      "description": "Type of unit or boiler.",
      "example": "Tangentially-fired"
    },
    "primaryFuelInfo": {
      "type": "string",
      "description": "The primary type of fuel combusted by the unit.",
      "example": "Coal"
    },
    "secondaryFuelInfo": {
      "type": "string",
      "description": "The secondary type of fuel(s) combusted by the unit.",
      "example": "Diesel Oil"
    },
    "so2ControlInfo": {
      "type": "string",
      "description": "Method or equipment used by the combustion unit to minimize SO2 emissions.",
      "example": "Wet Limestone"
    },
    "noxControlInfo": {
      "type": "string",
      "description": "Method or equipment used by the combustion unit to minimize NOx emissions.",
      "example": "Selective Catalytic Reduction, Low NOx Burner Technology w/ Separated OFA"
    },
    "pmControlInfo": {
      "type": "string",
      "description": "Method or equipment used by the combustion unit to minimize PM emissions.",
      "example": "Electrostatic Precipitator"
    },
    "hgControlInfo": {
      "type": "string",
      "description": "Method or equipment used by the combustion unit to minimize Hg emissions.",
      "example": "Catalyst (gold, palladium, or other) used to oxidize mercury"
    },
    "commercialOperationDate": {
      "type": "string",
      "description": "The date a unit began, or will begin to generate electricity for sale, including the sale of test generation. It is the first date that a unit serves a generator and produces electricity when connected to the grid, even if the owners are not compensated for that electricity.",
      "example": "1977-04-01"
    },
    "operatingStatus": {
      "type": "string",
      "description": "An indication of the condition of a unit relevant to the year (planned, operating, shutdown, etc.).",
      "example": "Operating"
    },
    "maxHourlyHIRate": {
      "type": "number",
      "description": "The design heat input capacity (mmBtu/hr) for the unit or the highest hourly heat input rate observed in the past five years, whichever is greater.",
      "example": 7969.2
    },
    "associatedGeneratorsAndNameplateCapacity": {
      "type": "string",
      "description": "One or more unique identifiers for generators at a facility associated with the unit, and the maximum electrical generating output (in MWe, rounded to the nearest tenth) that the generator is capable of producing on a steady state basis and during continuous operation (when not restricted by seasonal or other deratings). This value is usually indicated on a nameplate physically attached to the generator.",
      "example": "A1ST (191.8)"
    }
  },
  "required": [
    "stateCode",
    "facilityName",
    "unitId",
    "associatedStacks",
    "year",
    "programCodeInfo",
    "primaryRepInfo",
    "nercRegion",
    "county",
    "countyCode",
    "fipsCode",
    "sourceCategory",
    "ownerOperator",
    "so2Phase",
    "noxPhase",
    "unitType",
    "primaryFuelInfo",
    "secondaryFuelInfo",
    "so2ControlInfo",
    "noxControlInfo",
    "pmControlInfo",
    "hgControlInfo",
    "commercialOperationDate",
    "operatingStatus",
    "associatedGeneratorsAndNameplateCapacity"
  ]
}