Name: CarbonLedger API | EPA Facility Emissions & Carbon Offset Projects
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-carbonledger
Availability: InStock
Author: API Market

True Scary Stories

# CarbonLedger API

## Overview

The CarbonLedger API delivers two authoritative datasets in a single integration: EPA Greenhouse Gas Reporting Program (GHGRP) facility-level emissions data covering the nation's largest industrial emitters, paired with a global carbon offset project registry spanning Verra VCS, Gold Standard, Climate Action Reserve, and American Carbon Registry. Together, these datasets provide a structured, end-to-end view of industrial carbon output and the offset ecosystem designed to counteract it — making CarbonLedger an essential resource for developers, analysts, and researchers working at the intersection of climate data and real-world compliance.

## Features

*   **2 Dedicated Endpoints**: Access two distinct data categories — EPA-reported industrial facilities and verified carbon offset projects.
*   **Full-Text Search**: Filter records by keyword across all fields using the `?q=` query parameter.
*   **Pagination Support**: Efficiently manage large result sets with `?limit=` and `?offset=` parameters.
*   **Detailed Lookup**: Fetch any individual record directly by its unique ID.
*   **Authoritative Data**: All records are curated from official, primary sources — not auto-generated — including EPA GHGRP filings and registry databases from Verra VCS, Gold Standard, CAR, and ACR.
*   **High Availability**: A rate limit of 60 requests per minute across all plans.

## Use Cases

*   **ESG & Sustainability Platforms**: Surface facility-level emissions and verified offset data alongside investment portfolios to support ESG scoring, carbon accounting, and disclosure reporting under frameworks like TCFD, GRI, and CDP.
*   **Carbon Market Analytics**: Cross-reference industrial emitters with active offset projects to identify supply-demand dynamics, track credit issuance trends, and evaluate offset quality across registries.
*   **Climate Research & Policy**: Academics and policy analysts can access structured, machine-readable datasets to study sector-level emissions trends, offset effectiveness, and regulatory compliance patterns across U.S. industrial facilities.
*   **Compliance & Due Diligence Tools**: Legal, auditing, and consulting firms can programmatically verify whether facilities meet EPA reporting thresholds and whether offset projects cited by clients carry legitimate, registry-backed credits.
*   **Net-Zero Tracking Applications**: Developers building corporate sustainability dashboards can pair a company's reported emissions (via GHGRP) against offset project retirements to calculate and visualize net emissions positions over time.


## API Documentation

### Base URL

All API requests for the CarbonLedger API should be made to the following base URL:

```
'https://prod.api.market/api/v1/nicheapi-llc-1/carbonledger'
```

### Authentication

Authentication is handled via an API key. You must include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_MARKET_KEY
```

Replace `YOUR_API_MARKET_KEY` with your actual API key obtained from API.market.


### Endpoints

#### 1. List Facilities

Retrieve a paginated list of EPA GHGRP-reported facilities with optional search and filtering.

**Method**: `GET`
**Endpoint**: `/carbonledger/_facilities`

**Parameters**:

| Name     | In    | Description                                        | Type      | Required | Default | Max Value |
| :------- | :---- | :------------------------------------------------- | :-------- | :------- | :------ | :-------- |
| `q`      | query | Search query to filter facilities by keyword       | `string`  | No       |         |           |
| `limit`  | query | Maximum number of results per page                 | `integer` | No       | `50`    | `1000`    |
| `offset` | query | Number of results to skip for pagination           | `integer` | No       | `0`     |           |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/carbonledger/carbonledger/_facilities?q=Texas&limit=2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK)**:

```json
[
  {
    "id": "facility_1",
    "facility_name": "Baytown Refinery Complex",
    "city": "Baytown",
    "state": "TX",
    "county": "Harris County",
    "zip": "77520",
    "latitude": 29.7355,
    "longitude": -94.9774,
    "primary_naics_code": "324110",
    "industry_type": "Petroleum Refining",
    "total_reported_direct_emissions_mtco2e": 4821034,
    "reporting_year": 2023,
    "parent_company": "ExxonMobil Corporation",
    "ghgrp_facility_id": "1004537"
  },
  {
    "id": "facility_2",
    "facility_name": "Port Arthur LNG Terminal",
    "city": "Port Arthur",
    "state": "TX",
    "county": "Jefferson County",
    "zip": "77640",
    "latitude": 29.8988,
    "longitude": -93.9300,
    "primary_naics_code": "221210",
    "industry_type": "Natural Gas Distribution",
    "total_reported_direct_emissions_mtco2e": 1203488,
    "reporting_year": 2023,
    "parent_company": "Sempra Infrastructure",
    "ghgrp_facility_id": "1009821"
  }
]
```

---

#### 2. Get Facility by ID

Retrieve a single facility record by its unique identifier.

**Method**: `GET`
**Endpoint**: `/carbonledger/_facilities/{id}`

**Parameters**:

| Name | In   | Description                          | Type     | Required |
| :--- | :--- | :----------------------------------- | :------- | :------- |
| `id` | path | Unique identifier for the facility   | `string` | Yes      |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/carbonledger/carbonledger/_facilities/facility_1" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK)**:

```json
{
  "id": "facility_1",
  "facility_name": "Baytown Refinery Complex",
  "city": "Baytown",
  "state": "TX",
  "county": "Harris County",
  "zip": "77520",
  "latitude": 29.7355,
  "longitude": -94.9774,
  "primary_naics_code": "324110",
  "industry_type": "Petroleum Refining",
  "total_reported_direct_emissions_mtco2e": 4821034,
  "reporting_year": 2023,
  "parent_company": "ExxonMobil Corporation",
  "ghgrp_facility_id": "1004537"
}
```

---

#### 3. List Offset Projects

Retrieve a paginated list of verified carbon offset projects across Verra VCS, Gold Standard, Climate Action Reserve, and American Carbon Registry.

**Method**: `GET`
**Endpoint**: `/carbonledger/offset_projects`

**Parameters**:

| Name     | In    | Description                                           | Type      | Required | Default | Max Value |
| :------- | :---- | :---------------------------------------------------- | :-------- | :------- | :------ | :-------- |
| `q`      | query | Search query to filter offset projects by keyword     | `string`  | No       |         |           |
| `limit`  | query | Maximum number of results per page                    | `integer` | No       | `50`    | `1000`    |
| `offset` | query | Number of results to skip for pagination              | `integer` | No       | `0`     |           |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/carbonledger/carbonledger/offset_projects?q=REDD&limit=1" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK)**:

```json
[
  {
    "id": "offset_proj_1",
    "project_name": "Madre de Dios Amazon REDD+ Project",
    "registry": "Verra VCS",
    "registry_project_id": "VCS-944",
    "project_type": "REDD+ (Avoided Deforestation)",
    "methodology": "VM0015",
    "country": "Peru",
    "region": "Madre de Dios",
    "status": "Active",
    "total_credits_issued_tco2e": 8420000,
    "vintage_year_start": 2012,
    "vintage_year_end": 2042,
    "developer": "Amazon Conservation Association",
    "co_benefits": "Biodiversity, indigenous community support"
  }
]
```

---

#### 4. Get Offset Project by ID

Retrieve a single offset project record by its unique identifier.

**Method**: `GET`
**Endpoint**: `/carbonledger/offset_projects/{id}`

**Parameters**:

| Name | In   | Description                              | Type     | Required |
| :--- | :--- | :--------------------------------------- | :------- | :------- |
| `id` | path | Unique identifier for the offset project | `string` | Yes      |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/carbonledger/carbonledger/offset_projects/offset_proj_1" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK)**:

```json
{
  "id": "offset_proj_1",
  "project_name": "Madre de Dios Amazon REDD+ Project",
  "registry": "Verra VCS",
  "registry_project_id": "VCS-944",
  "project_type": "REDD+ (Avoided Deforestation)",
  "methodology": "VM0015",
  "country": "Peru",
  "region": "Madre de Dios",
  "status": "Active",
  "total_credits_issued_tco2e": 8420000,
  "vintage_year_start": 2012,
  "vintage_year_end": 2042,
  "developer": "Amazon Conservation Association",
  "co_benefits": "Biodiversity, indigenous community support"
}
```

---

## Status Codes

| Code  | Status                    | Description |
| :---- | :------------------------ | :---------- |
| `200` | OK                        | The request succeeded and data has been returned. |
| `400` | Bad Request               | The request contains invalid parameters or a malformed query. Review your request syntax. |
| `401` | Unauthorized              | The `x-api-market-key` header is missing or contains an invalid key. |
| `403` | Forbidden                 | Your API key is valid but lacks permission to access this resource. |
| `404` | Not Found                 | The requested endpoint or record ID does not exist. Verify the URL path and ID. |
| `429` | Too Many Requests         | You have exceeded the rate limit of 60 requests per minute. See the Rate Limits section. |
| `500` | Internal Server Error     | An unexpected server-side error occurred. Retry the request after a brief delay. |
| `503` | Service Unavailable       | The server is temporarily unavailable due to maintenance or high load. Retry after a short delay. |

---

## Rate Limits

The CarbonLedger API enforces a limit of **60 requests per minute** across all plans. If exceeded, the API returns a `429 Too Many Requests` response. To handle this gracefully, implement client-side throttling and exponential backoff in your application. Where provided, the `Retry-After` header in the 429 response will indicate how long to wait before retrying.

---

## FAQ

*   **What are the two datasets included in CarbonLedger?**
    The API combines EPA Greenhouse Gas Reporting Program (GHGRP) facility-level emissions data for large U.S. industrial emitters with a global carbon offset project registry covering Verra VCS, Gold Standard, Climate Action Reserve (CAR), and American Carbon Registry (ACR).

*   **What does `total_reported_direct_emissions_mtco2e` mean?**
    This field represents the total direct greenhouse gas emissions reported by a facility to the EPA GHGRP, expressed in metric tons of CO₂ equivalent (MTCO₂e) for the specified reporting year.

*   **Can I search across both endpoints simultaneously?**
    Not in a single request — each endpoint (`_facilities` and `offset_projects`) is queried separately. Use the `?q=` parameter on each to filter by keyword.

*   **How current is the emissions data?**
    The facility data reflects the most recent EPA GHGRP annual reporting cycle. EPA typically publishes finalized data approximately one year after the reporting period ends.

*   **How do I authenticate?**
    Include your API key in the `x-api-market-key` request header on every call. See the Authentication section above for details.

*   **What is the rate limit?**
    60 requests per minute across all plans. Exceeding this returns a `429` response.

*   **What registries are covered by the offset projects endpoint?**
    The offset project registry covers four major standards bodies: Verra VCS, Gold Standard, Climate Action Reserve (CAR), and American Carbon Registry (ACR).

---

## Contact

For questions or support, please reach out via the chat on the bottom right of the page or email **21truescarystories@gmail.com**.

Access EPA GHGRP emissions data for 200+ US industrial facilities and 50+ verified offset projects from Verra, Gold Standard, CAR & ACR. Ideal for ESG, carbon accounting, and research.

CarbonLedger API | EPA Facility Emissions & Carbon Offset Projects

Free

NicheAPI LLC

Mega

Bulk

EPA GHG Emissions & Carbon Offset Registry - EPA greenhouse gas emissions data for 216 major US industrial facilities plus 51 global carbon offset projects