# TruthBear Carbon Region Integrity Chain

> TruthBear Carbon Region Integrity Chain is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Returns a 3-leg carbon project integrity chain covering rating drift/downgrades, registry lifecycle status, and realized price integrity for a named carbon project or mechanism.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/carbon-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-carbon-region-integrity-chain-5f9c4913
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vmFAb-zxds9ZIjkB1vdxa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability truthbear-carbon-region-integrity-chain-5f9c4913
```

Example prompt: Pull the full 3-leg carbon integrity chain for the Kariba REDD project — I want to see rating drift and downgrade signals, its current registry lifecycle status, and whether price integrity is confirmed.

## When to prefer this

Choose this endpoint when you need a structured, multi-signal integrity assessment of a specific voluntary carbon project or methodology — especially when you want to cross-check rating drift, registry status, and price integrity in a single chained call. Prefer it over raw registry lookups when you need a confidence-scored summary across all three integrity dimensions and want Verra/Gold Standard sources aggregated automatically.

## Known failure modes

- 422 no_charge returned when no data exists for the requested entity — not billed
- Invalid or unrecognized entity ID results in 422 or empty response
- Missing required 'entity' query parameter causes request rejection
- Partial data availability may result in fewer than 3 legs lit, lowering confidence score

## How this service works

Truth Bear reports facts and their official sources — screening-grade, verifiable, not predictions or advice. Pay per call with USDC (x402) or a 30-day access pass by card / Apple Pay / Google Pay / PayPal.

## Output

A JSON object containing three sequential integrity legs: (1) leading rating drift, downgrades, and standard-body review signals; (2) current registry lifecycle status (listed, suspended, or de-listed); (3) realized price integrity confirmation. A confidence score reflects how many legs are fully lit. Returns HTTP 422 (no_charge) if no data is available for the requested entity.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "GET"
     ]
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
      "entity": {
       "type": "string",
       "description": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
       "examples": [
        "kariba-redd",
        "rimba-raya",
        "southern-cardamom",
        "cdm-mechanism",
        "vm0009-methodology",
        "vm0007-methodology"
       ],
       "x-accepted-values": {
        "shown": 6,
        "total": 19,
        "all": "https://api.truthbear.co/schemas/gauge-carbon-region.input.json"
       }
      }
     },
     "required": [
      "entity"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "queryParams"
   ]
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   },
   "required": [
    "type"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "lifecycle": {
    "band": "ended",
    "source_ref": "https://registry.verra.org/app/projectDetail/VCS/902",
    "record_hash": "sha256:3b19805563d036479d8500bf19f2fdcff728f2c085a269d96673246cf89e718c"
   },
   "rating_drift": {
    "band": "withdrawn",
    "source_ref": "https://registry.verra.org/app/projectDetail/VCS/902",
    "record_hash": "sha256:42b5328d7e2d4cff264e71f7450243369e5f49ea1da1e69852b6b44597afc5a9"
   },
   "price_integrity": {
    "band": "unsellable",
    "source_ref": "https://www.theguardian.com/environment/2023/oct/03/revealed-top-carbon-offset-firm-worthless-credits-south-pole-kariba-zimbabwe",
    "record_hash": "sha256:e659ab63d01cde8738c4eb486314bba31ef98582d3b56a551edcbbec363193be"
   }
  },
  "name": "Kariba REDD+ (VCS 902)",
  "grade": "screening-level, not decision-grade",
  "scope": {
   "full": "https://api.truthbear.co/scope/v1",
   "verifiability": "unknown",
   "monitoring_not_forecast": true,
   "intelligence_not_command": true
  },
  "entity": "kariba-redd",
  "nature": "This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction. Official source plus record_hash; verify with the free /gauge/verify.",
  "provenance": {
   "freshness": "recent",
   "age_hours_now": 143,
   "freshness_basis": "cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truthbear-carbon-region-integrity-chain-5f9c4913/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)