EPA — U.S. Environmental Protection Agency
CAM — Streaming Services

High-throughput streaming endpoints for accounts, allowances, facilities, and apportioned/raw emissions.
Documentation GitHub OpenAPI
OpenAPI Specification

{
  "openapi": "3.0.0",
  "paths": {
    "/streaming-services/health": {
      "get": {
        "operationId": "HealthController_check",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The Health Check is successful",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    },
                    "info": {
                      "type": "object",
                      "example": {
                        "database": {
                          "status": "up"
                        }
                      },
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      },
                      "nullable": true
                    },
                    "error": {
                      "type": "object",
                      "example": {},
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      },
                      "nullable": true
                    },
                    "details": {
                      "type": "object",
                      "example": {
                        "database": {
                          "status": "up"
                        }
                      },
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    }
                  }
                },
                "examples": {
                  "HealthController_check200Example": {
                    "summary": "Default HealthController_check 200 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "The Health Check is not successful",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "error"
                    },
                    "info": {
                      "type": "object",
                      "example": {
                        "database": {
                          "status": "up"
                        }
                      },
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      },
                      "nullable": true
                    },
                    "error": {
                      "type": "object",
                      "example": {
                        "redis": {
                          "status": "down",
                          "message": "Could not connect"
                        }
                      },
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      },
                      "nullable": true
                    },
                    "details": {
                      "type": "object",
                      "example": {
                        "database": {
                          "status": "up"
                        },
                        "redis": {
                          "status": "down",
                          "message": "Could not connect"
                        }
                      },
                      "additionalProperties": {
                        "type": "object",
                        "required": [
                          "status"
                        ],
                        "properties": {
                          "status": {
                            "type": "string"
                          }
                        },
                        "additionalProperties": true
                      }
                    }
                  }
                },
                "examples": {
                  "HealthController_check503Example": {
                    "summary": "Default HealthController_check 503 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Health"
        ],
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/streaming-services/facilities/attributes": {
      "get": {
        "operationId": "FacilitiesController_streamAttributes",
        "parameters": [
          {
            "name": "year",
            "required": true,
            "in": "query",
            "description": "The calendar year during which activity occurred.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              2024
            ]
          },
          {
            "name": "facilityId",
            "required": false,
            "in": "query",
            "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.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              0.0
            ]
          },
          {
            "name": "stateCode",
            "required": false,
            "in": "query",
            "description": "Two letter abbreviation for the State.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AL",
                  "AK",
                  "AS",
                  "AZ",
                  "AR",
                  "CA",
                  "CO",
                  "CT",
                  "DE",
                  "DC",
                  "FM",
                  "FL",
                  "GA",
                  "GU",
                  "HI",
                  "ID",
                  "IL",
                  "IN",
                  "IA",
                  "KS",
                  "KY",
                  "LA",
                  "ME",
                  "MH",
                  "MD",
                  "MA",
                  "MI",
                  "MN",
                  "MS",
                  "MO",
                  "MT",
                  "NE",
                  "NV",
                  "NH",
                  "NJ",
                  "NM",
                  "NY",
                  "NC",
                  "ND",
                  "MP",
                  "OH",
                  "OK",
                  "OR",
                  "PW",
                  "PA",
                  "PR",
                  "RI",
                  "SC",
                  "SD",
                  "TN",
                  "TX",
                  "UT",
                  "VT",
                  "VI",
                  "VA",
                  "WA",
                  "WV",
                  "WI",
                  "WY"
                ]
              }
            },
            "example": [
              "AL"
            ]
          },
          {
            "name": "unitType",
            "required": false,
            "in": "query",
            "description": "Type of unit or boiler.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Arch-fired boiler",
                  "Bubbling fluidized bed boiler",
                  "Cyclone boiler",
                  "Cell burner boiler",
                  "Combined cycle",
                  "Circulating fluidized bed boiler",
                  "Combustion turbine",
                  "Dry bottom wall-fired boiler",
                  "Dry bottom turbo-fired boiler",
                  "Dry bottom vertically-fired boiler",
                  "Internal combustion engine",
                  "Integrated gasification combined cycle",
                  "Cement Kiln",
                  "Other boiler",
                  "Other turbine",
                  "Pressurized fluidized bed boiler",
                  "Process Heater",
                  "Stoker",
                  "Tangentially-fired",
                  "Wet bottom wall-fired boiler",
                  "Wet bottom turbo-fired boiler",
                  "Wet bottom vertically-fired boiler"
                ]
              }
            },
            "example": [
              "Arch-fired boiler"
            ]
          },
          {
            "name": "unitFuelType",
            "required": false,
            "in": "query",
            "description": "Primary or Secondary fuel types combusted by the unit.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Coal",
                  "Coal Refuse",
                  "Diesel Oil",
                  "Liquified Petroleum Gas",
                  "Natural Gas",
                  "Other Gas",
                  "Other Oil",
                  "Other Solid Fuel",
                  "Petroleum Coke",
                  "Pipeline Natural Gas",
                  "Process Gas",
                  "Process Sludge",
                  "Refuse",
                  "Residual Oil",
                  "Tire Derived Fuel",
                  "Waste Liquid",
                  "Wood"
                ]
              }
            },
            "example": [
              "Coal"
            ]
          },
          {
            "name": "controlTechnologies",
            "required": false,
            "in": "query",
            "description": "Method or equipment used by the combustion unit to minimize Hg, NOx, PM, or SO2 emissions.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Additives to Enhance PAC and Existing Equipment Performance",
                  "Ammonia Injection",
                  "Baghouse",
                  "Catalyst (gold, palladium, or other) used to oxidize mercury",
                  "Combustion Modification/Fuel Reburning",
                  "Cyclone",
                  "Dry Lime FGD",
                  "Dry Low NOx Burners",
                  "Dry Sorbent Injection",
                  "Dual Alkali",
                  "Electrostatic Precipitator",
                  "Fluidized Bed Limestone Injection",
                  "Halogenated PAC Sorbent Injection",
                  "Hybrid ESP",
                  "Low NOx Burner Technology (Dry Bottom only)",
                  "Low NOx Burner Technology w/ Closed-coupled OFA",
                  "Low NOx Burner Technology w/ Closed-coupled/Separated OFA",
                  "Low NOx Burner Technology w/ Overfire Air",
                  "Low NOx Burner Technology w/ Separated OFA",
                  "Low NOx Cell Burner",
                  "Magnesium Oxide",
                  "Other",
                  "Other (Non PAC) Sorbent Injection",
                  "Overfire Air",
                  "Regenerative Activated Coke Technology",
                  "Selective Catalytic Reduction",
                  "Selective Non-catalytic Reduction",
                  "Sodium Based",
                  "Steam Injection",
                  "Untreated PAC Sorbent Injection",
                  "Water Injection",
                  "Wet ESP",
                  "Wet Lime FGD",
                  "Wet Limestone",
                  "Wet Scrubber"
                ]
              }
            },
            "example": [
              "Additives to Enhance PAC and Existing Equipment Performance"
            ]
          },
          {
            "name": "sourceCategory",
            "required": false,
            "in": "query",
            "description": "Description of a unit that classifies it in terms of the primary function of the unit.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Automotive Stampings",
                  "Bulk Industrial Chemical",
                  "Cement Manufacturing",
                  "Cogeneration",
                  "Electric Utility",
                  "Industrial Boiler",
                  "Industrial Turbine",
                  "Institutional",
                  "Iron & Steel",
                  "Municipal Waste Combustor",
                  "Pulp & Paper Mill",
                  "Petroleum Refinery",
                  "Portland Cement Plant",
                  "Small Power Producer",
                  "Theme Park"
                ]
              }
            },
            "example": [
              "Automotive Stampings"
            ]
          },
          {
            "name": "programCodeInfo",
            "required": false,
            "in": "query",
            "description": "Statutory or regulatory based options for tracking and reducing air pollution emissions.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "ARP",
                  "CAIRNOX",
                  "CAIROS",
                  "CAIRSO2",
                  "CSNOX",
                  "CSNOXOS",
                  "CSOSG1",
                  "CSOSG2",
                  "CSOSG2E",
                  "CSOSG3",
                  "CSSO2G1",
                  "CSSO2G2",
                  "NBP",
                  "NHNOX",
                  "NSPS4T",
                  "OTC",
                  "RGGI",
                  "SIPNOX",
                  "TXSO2"
                ]
              }
            },
            "example": [
              "ARP"
            ]
          },
          {
            "name": "exclude",
            "required": false,
            "in": "query",
            "description": "Selected items will be excluded from the response",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "associatedStacks",
                  "programCodeInfo",
                  "primaryRepInfo",
                  "epaRegion",
                  "nercRegion",
                  "county",
                  "countyCode",
                  "fipsCode",
                  "sourceCategory",
                  "latitude",
                  "longitude",
                  "so2Phase",
                  "noxPhase",
                  "primaryFuelInfo",
                  "secondaryFuelInfo",
                  "unitType",
                  "so2ControlInfo",
                  "pmControlInfo",
                  "noxControlInfo",
                  "hgControlInfo",
                  "commercialOperationDate",
                  "operatingStatus",
                  "maxHourlyHIRate",
                  "associatedGeneratorsAndNameplateCapacity",
                  "unit_id"
                ]
              }
            },
            "example": [
              "associatedStacks"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "Streams a list of Facilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FacilityAttributesDTO"
                },
                "examples": {
                  "FacilitiesController_streamAttributes200Example": {
                    "summary": "Default FacilitiesController_streamAttributes 200 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "example": "State,Facility Name,Facility ID,Unit ID,Associated Stacks,Year,Program Code,Primary Rep Info,EPA Region,NERC Region,County,County Code,FIPS Code,Source Category,Latitude,Longitude,Owner/Operator,SO2 Phase,NOx Phase,Unit Type,Primary Fuel Type,Secondary Fuel Type,SO2 Controls,NOx Controls,PM Controls,Hg Controls,Commercial Operation Date,Operating Status,Max Hourly HI Rate (mmBtu/hr),Associated Generators & Nameplate Capacity (MWe)"
                },
                "examples": {
                  "FacilitiesController_streamAttributes200Example": {
                    "summary": "Default FacilitiesController_streamAttributes 200 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid Request"
          },
          "404": {
            "description": "Resource Not Found"
          }
        },
        "security": [
          {
            "APIKey": []
          }
        ],
        "tags": [
          "Facilities"
        ],
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/streaming-services/accounts/attributes": {
      "get": {
        "operationId": "AccountController_streamAllAccountAttributes",
        "parameters": [
          {
            "name": "accountType",
            "required": false,
            "in": "query",
            "description": "Type of allowance account (Facility, General, etc.).",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Compliance Assurance Surrender Account",
                  "Enforcement Surrender Account",
                  "Facility Account",
                  "General Account",
                  "Overdraft Account",
                  "EPA Reserve Account",
                  "State Early Reduction Reserve Account",
                  "State General Reserve Account",
                  "State Holding Account",
                  "New Unit Set Aside Reserve Account",
                  "State Opt-In Reserve Account",
                  "State Other Reserve Account",
                  "State Primary Reserve Account",
                  "State Retirement Account",
                  "Surrender Account",
                  "Unit Account",
                  "Voluntary Surrender Account"
                ]
              }
            },
            "example": [
              "Compliance Assurance Surrender Account"
            ]
          },
          {
            "name": "accountNumber",
            "required": false,
            "in": "query",
            "description": "The unique identification number of an account.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "string"
            ]
          },
          {
            "name": "facilityId",
            "required": false,
            "in": "query",
            "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.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              0.0
            ]
          },
          {
            "name": "stateCode",
            "required": false,
            "in": "query",
            "description": "Two letter abbreviation for the State.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AL",
                  "AK",
                  "AS",
                  "AZ",
                  "AR",
                  "CA",
                  "CO",
                  "CT",
                  "DE",
                  "DC",
                  "FM",
                  "FL",
                  "GA",
                  "GU",
                  "HI",
                  "ID",
                  "IL",
                  "IN",
                  "IA",
                  "KS",
                  "KY",
                  "LA",
                  "ME",
                  "MH",
                  "MD",
                  "MA",
                  "MI",
                  "MN",
                  "MS",
                  "MO",
                  "MT",
                  "NE",
                  "NV",
                  "NH",
                  "NJ",
                  "NM",
                  "NY",
                  "NC",
                  "ND",
                  "MP",
                  "OH",
                  "OK",
                  "OR",
                  "PW",
                  "PA",
                  "PR",
                  "RI",
                  "SC",
                  "SD",
                  "TN",
                  "TX",
                  "UT",
                  "VT",
                  "VI",
                  "VA",
                  "WA",
                  "WV",
                  "WI",
                  "WY"
                ]
              }
            },
            "example": [
              "AL"
            ]
          },
          {
            "name": "ownerOperator",
            "required": false,
            "in": "query",
            "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.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "string"
            ]
          },
          {
            "name": "programCodeInfo",
            "required": false,
            "in": "query",
            "description": "Statutory or regulatory based options for tracking and reducing air pollution emissions.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "ARP",
                  "CAIRNOX",
                  "CAIROS",
                  "CAIRSO2",
                  "CSNOX",
                  "CSNOXOS",
                  "CSOSG1",
                  "CSOSG2",
                  "CSOSG2E",
                  "CSOSG3",
                  "CSSO2G1",
                  "CSSO2G2",
                  "NBP",
                  "OTC",
                  "TXSO2"
                ]
              }
            },
            "example": [
              "ARP"
            ]
          },
          {
            "name": "exclude",
            "required": false,
            "in": "query",
            "description": "Selected items will be excluded from the response",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "accountType",
                  "epaRegion",
                  "nercRegion",
                  "stateCode",
                  "unitId",
                  "unit_id"
                ]
              }
            },
            "example": [
              "accountType"
            ]
          }
        ],
        "responses": {
          "200": {
            "description": "Streams All Valid Account Attributes",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountAttributesDTO"
                },
                "examples": {
                  "AccountController_streamAllAccountAttributes200Example": {
                    "summary": "Default AccountController_streamAllAccountAttributes 200 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              },
              "text/csv": {
                "schema": {
                  "type": "string",
                  "example": "Account Number,Account Name,Program Code,Account Type,Facility ID,Unit ID,Owner/Operator,State,EPA Region,NERC Region"
                },
                "examples": {
                  "AccountController_streamAllAccountAttributes200Example": {
                    "summary": "Default AccountController_streamAllAccountAttributes 200 response",
                    "x-microcks-default": true,
                    "value": {
                      "status": "ok",
                      "message": "Example response"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid Request"
          },
          "404": {
            "description": "Resource Not Found"
          }
        },
        "security": [
          {
            "APIKey": []
          }
        ],
        "tags": [
          "Accounts"
        ],
        "x-microcks-operation": {
          "delay": 0,
          "dispatcher": "FALLBACK"
        }
      }
    },
    "/streaming-services/allowance-holdings": {
      "get": {
        "operationId": "AllowanceHoldingsController_streamAllowanceHoldings",
        "parameters": [
          {
            "name": "accountType",
            "required": false,
            "in": "query",
            "description": "Type of allowance account (Facility, General, etc.).",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Compliance Assurance Surrender Account",
                  "Enforcement Surrender Account",
                  "Facility Account",
                  "General Account",
                  "Overdraft Account",
                  "EPA Reserve Account",
                  "State Early Reduction Reserve Account",
                  "State General Reserve Account",
                  "State Holding Account",
                  "New Unit Set Aside Reserve Account",
                  "State Opt-In Reserve Account",
                  "State Other Reserve Account",
                  "State Primary Reserve Account",
                  "State Retirement Account",
                  "Surrender Account",
                  "Unit Account",
                  "Voluntary Surrender Account"
                ]
              }
            },
            "example": [
              "Compliance Assurance Surrender Account"
            ]
          },
          {
            "name": "accountNumber",
            "required": false,
            "in": "query",
            "description": "The unique identification number of an account.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "example": [
              "string"
            ]
          },
          {
            "name": "facilityId",
            "required": false,
            "in": "query",
            "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.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "example": [
              0.0
            ]
          },
          {
            "name": "stateCode",
            "required": false,
            "in": "query",
            "description": "Two letter abbreviation for the State.",
            "style": "pipeDelimited",
            "explode": false,
            "schema": {
              "typ

# --- truncated at 32 KB (505 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/epa/refs/heads/main/openapi/cam-streaming-openapi.json
CAM — Streaming Services

Documentation

Specifications

Examples

Schemas & Data

Other Resources

OpenAPI Specification
