Sign up
All data sources

EPA Envirofacts GHGRP

No authepa-ghg

EPA greenhouse gas (GHGRP), Toxic Release Inventory (TRI), and Facility Registry (FRS). Public data, no auth. GHG: searchFacilityEmissions, getEmissionsByFacility, searchBySector, getTopEmitters, searchSubpartW, getGHGByCounty, getGHGByYear, getGHGTrends, searchByZipCode TRI: searchTRIFacilities, getTRIReleases FRS: searchFRSFacilities CRITICAL USAGE RULES: 1. All methods accept { offset, limit } for pagination (default limit 100) 2. State filters use 2-letter abbreviation ('TX', 'CA') 3. searchBySector accepts natural-language aliases like { sector: 'Petroleum', subsector: 'Onshore Petroleum & Natural Gas Production' } 4. searchTRIFacilities supports county filters in addition to state/city/zip 5. Subpart W covers petroleum & natural gas systems specifically

environmentalcomplianceemissions
Get this contract as JSONConnect this source →

Provenance

PublisherEPA Envirofacts GHGRP
API basehttps://data.epa.gov/efservice

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationNo credentials required

Methods (12)

  • searchFacilityEmissions

    read

    Search GHG emissions by state, year, facility. sortBy="emissions" for top facilities.

    Required paramsstate or stateCode or state_code or year or facilityName or gasName
    Input schema
    {
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "stateCode": {
      "type": "string"
    },
    "state_code": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "facilityName": {
      "type": "string"
    },
    "gasName": {
      "type": "string"
    },
    "sortBy": {
      "type": "string"
    },
    "sortOrder": {
      "type": "string"
    },
    "aggregateByFacility": {
      "type": "boolean"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "state"
          ]
        },
        {
          "required": [
            "stateCode"
          ]
        },
        {
          "required": [
            "state_code"
          ]
        },
        {
          "required": [
            "year"
          ]
        },
        {
          "required": [
            "facilityName"
          ]
        },
        {
          "required": [
            "gasName"
          ]
        }
      ]
    }
  ]
}

  • getEmissionsByFacility

    read

    All GHG emissions (by gas type) for a specific facility.

    Required paramsfacilityId or facility_id
    Input schema
    {
  "type": "object",
  "properties": {
    "facilityId": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "facility_id": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "year": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "facilityId"
          ]
        },
        {
          "required": [
            "facility_id"
          ]
        }
      ]
    }
  ]
}

  • searchBySector

    read

    Search GHG emissions by sector, subsector, state, year. Accepts natural-language aliases.

    Required paramssectorName or sector or subsectorName or subsector or subsectorDescription or state or year
    Input schema
    {
  "type": "object",
  "properties": {
    "sectorName": {
      "type": "string"
    },
    "sector": {
      "type": "string"
    },
    "subsectorName": {
      "type": "string"
    },
    "subsector": {
      "type": "string"
    },
    "subsectorDescription": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "sectorName"
          ]
        },
        {
          "required": [
            "sector"
          ]
        },
        {
          "required": [
            "subsectorName"
          ]
        },
        {
          "required": [
            "subsector"
          ]
        },
        {
          "required": [
            "subsectorDescription"
          ]
        },
        {
          "required": [
            "state"
          ]
        },
        {
          "required": [
            "year"
          ]
        }
      ]
    }
  ]
}

  • getTopEmitters

    read

    Top GHG-emitting facilities, optionally scoped by state/year.

    Input schema
    {
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

  • searchSubpartW

    read

    Subpart W (petroleum & natural gas systems) emissions search.

    Input schema
    {
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "facilityName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false
}

  • searchTRIFacilities

    read

    Search TRI facilities by state, county, city, zip, or name (EPA Envirofacts GHGRP).

    Required paramsstate or stateCode or state_code or county or city or zip or facilityName
    Input schema
    {
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "stateCode": {
      "type": "string"
    },
    "state_code": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "zip": {
      "type": "string"
    },
    "facilityName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "state"
          ]
        },
        {
          "required": [
            "stateCode"
          ]
        },
        {
          "required": [
            "state_code"
          ]
        },
        {
          "required": [
            "county"
          ]
        },
        {
          "required": [
            "city"
          ]
        },
        {
          "required": [
            "zip"
          ]
        },
        {
          "required": [
            "facilityName"
          ]
        }
      ]
    }
  ]
}

  • getTRIReleases

    read

    TRI toxic release records for a specific facility (EPA Envirofacts GHGRP).

    Required paramsfacilityId or facility_id
    Input schema
    {
  "type": "object",
  "properties": {
    "facilityId": {
      "type": "string"
    },
    "facility_id": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "facilityId"
          ]
        },
        {
          "required": [
            "facility_id"
          ]
        }
      ]
    }
  ]
}

  • searchFRSFacilities

    read

    Greenhouse gas reporting (GHGRP) facility registry search by state, city, zip, name.

    Required paramsstate or stateCode or state_code or city or zip or facilityName
    Input schema
    {
  "type": "object",
  "properties": {
    "state": {
      "type": "string"
    },
    "stateCode": {
      "type": "string"
    },
    "state_code": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "zip": {
      "type": "string"
    },
    "facilityName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "state"
          ]
        },
        {
          "required": [
            "stateCode"
          ]
        },
        {
          "required": [
            "state_code"
          ]
        },
        {
          "required": [
            "city"
          ]
        },
        {
          "required": [
            "zip"
          ]
        },
        {
          "required": [
            "facilityName"
          ]
        }
      ]
    }
  ]
}

  • getGHGByCounty

    read

    GHG emissions filtered by county (state optional).

    Required paramscounty or countyName or county_name
    Input schema
    {
  "type": "object",
  "properties": {
    "county": {
      "type": "string"
    },
    "countyName": {
      "type": "string"
    },
    "county_name": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "county"
          ]
        },
        {
          "required": [
            "countyName"
          ]
        },
        {
          "required": [
            "county_name"
          ]
        }
      ]
    }
  ]
}

  • getGHGByYear

    read

    GHG emissions for a specific reporting year.

    Required paramsyear
    Input schema
    {
  "type": "object",
  "properties": {
    "year": {
      "type": "number"
    },
    "state": {
      "type": "string"
    },
    "gasName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "required": [
    "year"
  ]
}

  • getGHGTrends

    read

    Multi-year GHG emissions trend for a single facility. Accepts facilityId or facility_id.

    Required paramsfacilityId or facility_id
    Input schema
    {
  "type": "object",
  "properties": {
    "facilityId": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "facility_id": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "gasName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "allOf": [
    {
      "anyOf": [
        {
          "required": [
            "facilityId"
          ]
        },
        {
          "required": [
            "facility_id"
          ]
        }
      ]
    }
  ]
}

  • searchByZipCode

    read

    GHG emissions filtered by ZIP code.

    Required paramszip
    Input schema
    {
  "type": "object",
  "properties": {
    "zip": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "gasName": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "additionalProperties": false,
  "required": [
    "zip"
  ]
}