# TruthBear Biodiversity Region Gauge

> TruthBear Biodiversity Region Gauge 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 sequential chain assessment of biodiversity credit health for a monitored entity, covering registry status, methodology revision pressure, and realized lifecycle outcome.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/biodiversity-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-biodiversity-region-gauge-ad94c636
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WxiofZi1Qnd6xRNuCx5iL

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-biodiversity-region-gauge-ad94c636
```

Example prompt: Pull the current biodiversity credit chain reading for uk-bng-warwickshire — I want to see the registry status, whether there's methodology revision pressure, and the lifecycle outcome confidence.

## When to prefer this

Use this endpoint when you need a structured, multi-leg integrity view of a specific biodiversity credit project or standard body — especially for UK BNG, Plan Vivo, Verra, or Terrasos entities. It is descriptive only (never a forecast or advice), making it suitable for compliance monitoring, due diligence workflows, and ESG integrity checks. Prefer it over generic registry queries when you need leading-indicator signals (methodology revision pressure, standard-body pipeline) chained with current registry state and lifecycle confirmation in a single call.

## Known failure modes

- 422 no_charge: no data available for the requested entity — not billed
- 400/422: missing required 'entity' query parameter
- Unknown or unsupported entity ID: check GET /gauge/catalog?signal_id=<signal_id> for valid entities
- Partial chain: confidence may be low if only some legs have data, not an error but a data quality signal

## How this service works

[3-LEG] Biodiversity credit chain, one project (?entity=uk-bng-warwickshire): leading standard-body pressure - registry, methodology or rating change -> current current registry state -> realized lifecycle outcome (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: registry and standard-body feeds. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A JSON object representing the 3-leg sequential chain for the requested biodiversity entity: leg 1 (leading standard-body pipeline pressure signals such as registry status change, methodology revision, or rating downgrade), leg 2 (current registry state), and leg 3 (realized lifecycle outcome confirmation). A confidence value reflects how many legs are sequentially lit. Returns 422 with no_charge if no data is available for the entity; the call is not billed in that case.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "entity"
     ],
     "properties": {
      "entity": {
       "type": "string",
       "examples": [
        "uk-bng-statutory-units",
        "uk-bng-register",
        "wallacea-methodology",
        "plan-vivo-pv-nature",
        "verra-nature-framework",
        "terrasos-habitat-banks"
       ],
       "description": "required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]",
       "x-accepted-values": {
        "all": "https://api.truthbear.co/schemas/gauge-biodiversity-region.input.json",
        "shown": 6,
        "total": 18
       }
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "lifecycle": {
    "band": "operating",
    "source_ref": "https://www.gov.uk/guidance/biodiversity-net-gain",
    "record_hash": "sha256:887ea95c344be423324546a1442b30e5bd78fdab0647a8582fb16653a93c8313"
   },
   "mrv_integrity_drift": {
    "band": "sound",
    "source_ref": "https://www.gov.uk/guidance/biodiversity-net-gain",
    "record_hash": "sha256:dd4862ba0efe8183ce5f3a663402bf9947777ad71c9f3c5b8967a9e4e996d910"
   },
   "buyer_holder_cascade": {
    "band": "none",
    "source_ref": "https://www.gov.uk/guidance/biodiversity-net-gain",
    "record_hash": "sha256:003a4bbd7e4ade0b73ba88b7da7b07d6f056bc78b44eecdd12e5fa42ae8d7bfe"
   }
  },
  "name": "UK Biodiversity Net Gain statutory units",
  "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": "uk-bng-statutory-units",
  "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": 154,
   "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-biodiversity-region-gauge-ad94c636/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)
