RCP API Reference: Accessing the Framework Programmatically

The RCP REST API endpoint allows software developers, ESG platforms, and job management systems to programmatically access the full Restoration Carbon Protocol framework — all articles, emission factors, schema documentation, and article relationships — without scraping the site. This endpoint is part of the Tygart Media REST API and is publicly accessible without authentication.

Base URL: https://tygartmedia.com/wp-json/tygart/v1/rcp


Endpoints

GET /wp-json/tygart/v1/rcp

Returns the complete RCP framework index: all published articles with metadata, their relationship type within the framework, and links to full content.

Request:

GET https://tygartmedia.com/wp-json/tygart/v1/rcp
Accept: application/json

Response structure:

{
  "rcp_version": "1.0",
  "schema_version": "RCP-JCR-1.0",
  "last_updated": "2026-04-11",
  "framework_url": "https://tygartmedia.com/rcp/",
  "contact": "rcp@tygartmedia.com",
  "license": "CC BY 4.0",
  "articles": [
    {
      "id": 2481,
      "type": "introduction",
      "title": "Introducing the Restoration Carbon Protocol",
      "url": "https://tygartmedia.com/restoration-carbon-protocol-introduction/",
      "excerpt": "...",
      "tags": ["RCP", "GHG Protocol", "ESG", "Scope 3"]
    },
    ...
  ],
  "article_types": [
    "introduction", "regulatory", "job_type_guide",
    "data_standard", "commercial", "technical", "strategy"
  ]
}

GET /wp-json/tygart/v1/rcp/schema

Returns the full RCP-JCR-1.0 JSON Schema for a Job Carbon Report — the machine-readable data standard for per-job Scope 3 emissions records. This is the canonical schema endpoint for software developers implementing native RCP data capture.

Request:

GET https://tygartmedia.com/wp-json/tygart/v1/rcp/schema
Accept: application/json

Response: Full JSON Schema Draft-07 object as published in the RCP JSON Schema v1.0 article.

GET /wp-json/tygart/v1/rcp/factors

Returns all RCP emission factors as structured JSON — vehicle emission factors, material factors, waste disposal factors, demolished building material factors, and the eGRID subregional table. This allows ESG platforms and carbon calculators to pull the current RCP factor set programmatically rather than hardcoding values.

Request:

GET https://tygartmedia.com/wp-json/tygart/v1/rcp/factors
Accept: application/json

Response structure:

{
  "factor_vintage": "EPA 2025 EF Hub, EPA eGRID 2023, EPA WARM v16, DEFRA 2024",
  "gwp_basis": "IPCC AR6 GWP-100 for refrigerants; IPCC AR5 for other gases",
  "last_updated": "2026-04-11",
  "transportation": {
    "units": "kg_co2e_per_mile",
    "factors": {
      "passenger_car_gasoline": 0.355,
      "light_truck_gasoline": 0.503,
      "light_truck_diesel": 0.523,
      "medium_truck_diesel": 1.084,
      "heavy_truck_unloaded": 1.612,
      "heavy_truck_loaded": 2.25,
      "hazmat_hauler_acm": 3.20,
      "medical_waste_hauler": 2.80
    }
  },
  "electricity": {
    "units": "kg_co2e_per_kwh",
    "national_average": 0.3497,
    "subregions": {
      "NYUP": 0.1101,
      "CAMX": 0.1950,
      "NEWE": 0.2464,
      "ERCT": 0.3341,
      "FRCC": 0.3560,
      "SRSO": 0.3837,
      "NYCW": 0.3927
    }
  },
  "waste_disposal": {
    "units": "tco2e_per_short_ton",
    "factors": {
      "mixed_cd_landfill": 0.16,
      "gypsum_drywall_landfill": 0.16,
      "gypsum_drywall_recycled": 0.02,
      "carpet_pad_landfill": 0.33,
      "carpet_pad_recycled": 0.05,
      "vinyl_lvp_landfill": 0.28,
      "vinyl_lvp_recycled": 0.08,
      "mixed_plastics_landfill": 0.25,
      "biohazard_incineration": 0.97,
      "biohazard_autoclave_landfill": 0.50,
      "acm_inert_transport_only": 0.018
    }
  },
  "materials_kg_co2e_per_unit": {
    "nitrile_glove_each": 0.0277,
    "n95_respirator_each": 0.05,
    "tyvek_suit_each": 0.52,
    "h2o2_antimicrobial_per_kg_active": 1.33,
    "lvp_flooring_per_m2": 5.2,
    "ceramic_tile_per_kg": 0.78,
    "ready_mix_concrete_per_kg": 0.13,
    "ldpe_sheeting_per_kg": 1.793
  },
  "refrigerant_gwp_ar6": {
    "R410A_blend": 2256,
    "R32": 771,
    "R454B_blend": 530,
    "R134a": 1530
  },
  "fuel_combustion": {
    "units": "kg_co2e_per_gallon",
    "gasoline": 8.887,
    "diesel": 10.21
  }
}

GET /wp-json/tygart/v1/rcp/articles/{type}

Returns articles filtered by framework type. Valid type values: job_type_guide, regulatory, data_standard, technical, strategy, introduction, commercial.

Example — get all job type guides:

GET https://tygartmedia.com/wp-json/tygart/v1/rcp/articles/job_type_guide

Response: Array of article objects matching that type, with title, URL, excerpt, and job_types array (e.g., ["water_damage", "category_2", "category_3"]).


Existing WordPress REST API — RCP Queries

While the tygart/v1/rcp endpoints above are planned for v1.1 deployment, the existing WordPress REST API at /wp-json/wp/v2/ already supports filtered RCP queries using tag and category IDs.

Get all RCP articles

GET https://tygartmedia.com/wp-json/wp/v2/posts?tags=409&per_page=50
# Tag 409 = "RCP" — returns all 30 published RCP articles

Get RCP articles by sub-type

# Developer/technical articles only (tag 411 = Developer Reference)
GET https://tygartmedia.com/wp-json/wp/v2/posts?tags=409,411&per_page=20

# Regulatory articles (tag 369 = SB 253)
GET https://tygartmedia.com/wp-json/wp/v2/posts?tags=409,369&per_page=20

Get a specific article with full content

# RCP v1.0 Full Framework Document (post ID 2976)
GET https://tygartmedia.com/wp-json/wp/v2/posts/2976

# Returns: id, title, content.rendered, excerpt.rendered, 
#          link, slug, date, modified, tags, categories

Get the RCP hub page

GET https://tygartmedia.com/wp-json/wp/v2/pages?slug=rcp
# Returns the hub page at /rcp/ with full content and navigation structure

Response fields available per post

Field Type Description
id integer WordPress post ID — stable across updates
slug string URL slug — permanent, do not rely on for API queries (use ID)
title.rendered string HTML-decoded article title
content.rendered string Full article HTML — includes all tables, methodology, worked examples
excerpt.rendered string Summary paragraph — suitable for search result snippets
link string Canonical URL
modified datetime Last updated — use to detect emission factor version updates
tags array[int] Tag IDs — use 409 (RCP), 411 (Developer) for filtering

RCP Tag ID Reference

Tag ID Name Use
409 RCP All RCP articles — primary filter for the full framework
408 GHG Protocol All RCP articles (GHG Protocol aligned)
366 Scope 3 All RCP articles (Scope 3 focused)
77 ESG All RCP articles (ESG context)
411 Developer Reference Technical articles: JSON schema, proxy guide, factor table, audit guide, software integration, 12 data points
369 SB 253 Regulatory articles: SB 253, framework, FEMA, SBTi, CSRD

Planned v1.1 API Enhancements (Roadmap)

The following endpoints are targeted for deployment in RCP v1.1, pending implementation by the infrastructure team. The spec above defines the intended response format.

  • GET /wp-json/tygart/v1/rcp — Framework index with article type classification
  • GET /wp-json/tygart/v1/rcp/schema — RCP-JCR-1.0 JSON Schema as a clean API response
  • GET /wp-json/tygart/v1/rcp/factors — All emission factors as structured JSON with vintage metadata
  • GET /wp-json/tygart/v1/rcp/factors/{category} — Filtered factor sets (transportation, electricity, waste, materials)
  • GET /wp-json/tygart/v1/rcp/articles/{type} — Articles filtered by framework type

Software vendors who want to implement the planned endpoints ahead of formal deployment, or who have implementation questions, contact: rcp@tygartmedia.com


Continue Reading

See Also

Return to RCP Knowledge Base

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *