# Voyage Carbon Compliance Evidence

> Voyage Carbon Compliance Evidence is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-12).

Returns structured compliance evidence and regulatory status for a specific maritime voyage under carbon/ETS regulations

## Facts

- Endpoint: POST https://api.timzinin.com/api/voyage-carbon-compliance-evidence?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/voyage-carbon-compliance-evidence-02bbbb90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sW0sMZg5V1U2sTq5DkxKL

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 voyage-carbon-compliance-evidence-02bbbb90 -d '<json body>'
```

Example prompt: Can you check the carbon compliance evidence for vessel o_7dc546b848eaf85258d7499ca99efc71bc5a7627c53a658b1804 on voyage o_5fa3c19b50d19b9f4931b99862f51cd2cecf25ee664ffc45220a and tell me whether there's an ETS surrender obligation and what the confidence level of that assessment is?

## When to prefer this

Use this endpoint when you need cryptographically-anchored, pay-per-call compliance evidence for a specific maritime voyage under carbon/ETS regulations, particularly when you need verifiable digests (vessel identity, voyage identity, input contract) for audit trails. Prefer this over generic emissions databases when you require structured rule versioning, surrender deadlines, and truth ledger entries that can be presented as regulatory evidence.

## Known failure modes

- Unknown or invalid vessel/voyage identity — returns result with status 'not_available' and no decision
- Demo mode response when no real decision data exists — returns synthetic_demo_no_decision status
- Confidence level 'not_assessed' when MRV verification has not been performed
- Payment failure via x402 protocol — call not executed
- Malformed request digest or contract digest — may return error or unresolvable identity

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a structured JSON object containing: the compliance rule applied (status, phase-in, ETS gases, rule version, reporting year, surrender year and deadline, accepted-through year, digest hashes), the result decision and status, confidence level with reasons, data quality assessment (completeness, truth mix, partial flag), a truth ledger with verified inputs and coverage status, and input identity digests for the vessel and voyage. Also includes run time and settlement confirmation in the meta block.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "legs": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "legId",
     "departurePortCallId",
     "arrivalPortCallId",
     "departureAt",
     "arrivalAt",
     "fuelRecords"
    ],
    "properties": {
     "legId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
     },
     "arrivalAt": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
     },
     "departureAt": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
     },
     "fuelRecords": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "recordId",
        "consumptionStartAt",
        "consumptionEndAt",
        "fuelType",
        "massTonnes",
        "dataTruth"
       ],
       "properties": {
        "fuelType": {
         "enum": [
          "HFO",
          "LFO",
          "MDO_MGO",
          "LNG",
          "BIO_LNG",
          "LPG_BUTANE",
          "LPG_PROPANE",
          "METHANOL",
          "BIOFUEL",
          "OTHER"
         ],
         "type": "string"
        },
        "recordId": {
         "type": "string",
         "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
        },
        "dataTruth": {
         "enum": [
          "measured",
          "buyer_reported",
          "estimated"
         ],
         "type": "string"
        },
        "massTonnes": {
         "type": "string",
         "pattern": "^(0|[1-9][0-9]*)(?:\\.[0-9]{0,5}[1-9])?$"
        },
        "consumptionEndAt": {
         "type": "string",
         "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
        },
        "consumptionStartAt": {
         "type": "string",
         "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"
        }
       },
       "additionalProperties": false
      },
      "maxItems": 4,
      "minItems": 1
     },
     "arrivalPortCallId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
     },
     "departurePortCallId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 8,
   "minItems": 1
  },
  "mode": {
   "enum": [
    "decision",
    "synthetic_demo"
   ],
   "type": "string"
  },
  "portCalls": {
   "type": "array",
   "items": {
    "type": "object",
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "rule": {
     "reason": "synthetic_demo_no_decision",
     "status": "not_applied",
     "phaseIn": null,
     "etsGases": [],
     "ruleVersion": null,
     "reportingYear": null,
     "ruleSetDigest": null,
     "surrenderYear": null,
     "sourceModeDigest": null,
     "surrenderDeadline": null,
     "acceptedThroughYear": 2027,
     "sourceManifestDigest": null
    },
    "actor": "voyage-carbon-compliance-evidence",
    "result": {
     "reason": "synthetic_demo_no_decision",
     "status": "not_available",
     "decision": null
    },
    "status": "demo",
    "sources": [],
    "confidence": {
     "level": "not_assessed",
     "reasons": [
      "no_decision_data"
     ]
    },
    "dataQuality": {
     "partial": false,
     "reasons": [
      "no_decision_data"
     ],
     "truthMix": "none",
     "completeness": "not_applicable",
     "privateInputPersisted": false
    },
    "limitations": [],
    "resultFound": false,
    "truthLedger": {
     "reason": "synthetic_demo_no_decision",
     "status": "not_evaluated",
     "entries": [],
     "verifiedInputs": [],
     "coverageComplete": false,
     "verificationReason": "mrv_verification_not_performed"
    },
    "inputIdentity": {
     "requestIdDigest": "c3d87172dfa7be877b8ad6063861920b90c2eb0b88d6a07bdc26f575c771503e",
     "inputContractDigest": "1f4f44db912e64baf7dea18f01b9598c979441d7727a2fc0e193f7cecdeb7883",
     "requestDigestStatus": "available",
     "vesselIdentityDigest": "o_7dc546b848eaf85258d7499ca99efc71bc5a7627c53a658b1804",
     "voyageIdentityDigest": "o_5fa3c19b50d19b9f4931b99862f51cd2cecf25ee664ffc45220a",
     "privatePayloadPersisted": false
    },
    "requestDigest": "15dfa6990f7ade4e7384d045111d849b0078d9b31c66daa33095bfd90cfe9610",
    "schemaVersion": "1.1.0"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/voyage-carbon-compliance-evidence-02bbbb90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)