{"uid":"cap_sW0sMZg5V1U2sTq5DkxKL","slug":"voyage-carbon-compliance-evidence-02bbbb90","name":"Voyage Carbon Compliance Evidence","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/voyage-carbon-compliance-evidence?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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","required":["portCallId","unlocode","memberStatePort","isPortOfCall","specialTreatment","startedAt","endedAt"],"properties":{"endedAt":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"},"unlocode":{"type":"string","pattern":"^[A-Z0-9]{5}$"},"startedAt":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$"},"portCallId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"},"isPortOfCall":{"type":"boolean"},"memberStatePort":{"type":"boolean"},"specialTreatment":{"enum":["ordinary","excluded_stop","neighbouring_container_transhipment","unknown"],"type":"string"}},"additionalProperties":false},"maxItems":9,"minItems":2},"requestId":{"type":"string","maxLength":64},"berthRecords":{"type":"array","items":{"type":"object","required":["recordId","portCallId","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])?$"},"portCallId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"},"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":18},"schemaVersion":{"type":"string"}}},"responseSchema":{"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"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mvm-zlgY8fUamT3yUlqyk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured compliance evidence and regulatory status for a specific maritime voyage under carbon/ETS regulations","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"ETS Surrender Obligation Check","prompt":"I need to know if vessel o_7dc546b848eaf85258d7499ca99efc71bc5a7627c53a658b1804 has any carbon allowance surrender obligations for its recent voyage — can you pull the compliance evidence including the surrender deadline and which ETS gases apply?"},{"title":"Automated Voyage Compliance Audit","prompt":"For our fleet audit, check the carbon compliance status on voyage o_5fa3c19b50d19b9f4931b99862f51cd2cecf25ee664ffc45220a and return the rule version, reporting year, and whether the data quality is complete enough to make a decision."},{"title":"Carbon Regulatory Evidence for Port Authority","prompt":"We need to present compliance evidence to the port authority showing that this voyage met carbon reporting requirements — can you retrieve the truth ledger and verification status for voyage o_5fa3c19b50d19b9f4931b99862f51cd2cecf25ee664ffc45220a on vessel o_7dc546b848eaf85258d7499ca99efc71bc5a7627c53a658b1804?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:38:19.055Z","isFirstParty":false,"canonicalSlug":"voyage-carbon-compliance-evidence-02bbbb90"}