{"x402Version":2,"apiVersion":"0.2.1","service":{"name":"Klima Retirement Aggregator","description":"Programmatic carbon-credit retirement via Klima Protocol on Base. Single multiplexed URL exposes 6 actions: discover (list credits), quote (live price), prepare/retire (encode calldata for self-submitted retirement), prepare-auth (build the EIP-712 authorization to sign for a relayed retirement), actions/retire (relay a signed authorization on-chain and return the certificate), certificate (resolve the Carbonmark certificate URL). The read/encode actions are free; actions/retire performs a non-custodial retirement funded by the caller's signed authorization (the service never custodies funds).","operator":"KlimaDAO","homepage":"https://github.com/Carbonmark/x402-klima-RA-new","documentation":"https://github.com/Carbonmark/x402-klima-RA-new/blob/main/Readme.MD"},"endpoints":[{"url":"https://x402.klimalabs.com/api","method":"POST","description":"Klima Retirement Aggregator action multiplexer. POST a JSON body with an `action` field.","actions":[{"name":"discover","fee":"0","description":"List available carbon classes and credits with registry/vintage/Puro metadata. Optionally filter with `carbonClass`, `creditToken`, and/or `maxUsdcPricePerTonne` (AND-combined) to narrow the catalog; `creditToken` also trims the matched class down to that one credit.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"discover"},"carbonClass":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"maxUsdcPricePerTonne":{"type":"string","minLength":1}},"additionalProperties":false,"required":["action"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"carbonClasses":{"type":"array","items":{"type":"object","properties":{"carbonClassId":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"methodologies":{"type":"array","items":{}},"isRegistered":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"priceUsdcPerTonne":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceUsdcPerTonneFormatted":{"anyOf":[{"type":"string"},{"type":"null"}]},"credits":{"type":"array","items":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},"creditsDetailed":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"tokenStandard":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenId":{"type":"number"},"registry":{"anyOf":[{"type":"string"},{"type":"null"}]},"projectId":{"anyOf":[{"type":"string"},{"type":"null"}]},"vintage":{"anyOf":[{"type":"number"},{"type":"null"}]},"liquidity":{"type":"string"},"liquidityFormatted":{"type":"string"}},"required":["tokenAddress","tokenStandard","tokenId","registry","projectId","vintage","liquidity","liquidityFormatted"],"additionalProperties":false}},"minRetirementTonnes":{"type":"string"},"minRetirementTonnesFormatted":{"type":"string"},"minRetirementNote":{"type":"string"}},"required":["carbonClassId","name","category","country","region","methodologies","isRegistered","priceUsdcPerTonne","priceUsdcPerTonneFormatted","credits","creditsDetailed","minRetirementTonnes","minRetirementTonnesFormatted","minRetirementNote"],"additionalProperties":false}},"contracts":{"type":"object","properties":{"retirementAggregator":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"klimaProtocolAAM":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"kVCM":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"USDC":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}},"required":["retirementAggregator","klimaProtocolAAM","kVCM","USDC"],"additionalProperties":false},"supportedInputTokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"decimals":{"type":"number"}},"required":["symbol","address","decimals"],"additionalProperties":false}},"supportedCreditTypes":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"standard":{"type":"string"},"bridge":{"type":"string"},"status":{"type":"string"}},"required":["type","standard","bridge"],"additionalProperties":false}},"x402FacilitatorVersion":{"type":"number"},"note":{"type":"string"}},"required":["carbonClasses","contracts","supportedInputTokens","supportedCreditTypes","x402FacilitatorVersion","note"],"additionalProperties":false}},{"name":"quote","fee":"0","description":"Live on-chain price quote for a (creditToken, amount, inputToken, carbonClass) combination. Returns atomic + decimal-formatted price/maxInput.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"quote"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"inputToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amount":{"type":"string","minLength":1},"carbonClass":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"vintage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokenId":{"type":"string","minLength":1}},"required":["action","chainId","inputToken","amount","carbonClass"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"tonnes":{"type":"string"},"tonnesFormatted":{"type":"string"},"retirementPrice":{"type":"string"},"retirementPriceFormatted":{"type":"string"},"fee":{"type":"string"},"feeFormatted":{"type":"string"},"total":{"type":"string"},"totalFormatted":{"type":"string"},"suggestedMaxInput":{"type":"string"},"suggestedMaxInputFormatted":{"type":"string"},"pricePerTonne":{"type":"string"},"pricePerTonneFormatted":{"type":"string"},"maxUsdcPricePerTonne":{"type":"string"},"maxUsdcPricePerTonneFormatted":{"type":"string"},"inputTokenSymbol":{"type":"string"},"inputTokenDecimals":{"type":"number"},"slippageBps":{"type":"number"},"humanSummary":{"type":"string"},"resolvedCredit":{"type":"object","properties":{"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"tokenId":{"type":"number"},"vintage":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["creditToken","tokenId","vintage"],"additionalProperties":false},"alternatives":{"type":"array","items":{"type":"object","properties":{"tokenId":{"type":"number"},"vintage":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["tokenId","vintage"],"additionalProperties":false}}},"required":["tonnes","tonnesFormatted","retirementPrice","retirementPriceFormatted","fee","feeFormatted","total","totalFormatted","suggestedMaxInput","suggestedMaxInputFormatted","pricePerTonne","pricePerTonneFormatted","maxUsdcPricePerTonne","maxUsdcPricePerTonneFormatted","inputTokenSymbol","inputTokenDecimals","slippageBps","humanSummary","resolvedCredit","alternatives"],"additionalProperties":false}},{"name":"prepare/retire","fee":"0","description":"Encode calldata + ERC-20 approval instructions for a single self-submitted retirement (caller signs and broadcasts the tx with their own wallet). Off-chain only — does not broadcast. GET alias: /api/prepare/retire.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"prepare/retire"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"inputToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amount":{"type":"string","minLength":1},"carbonClass":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"vintage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokenId":{"type":"string","minLength":1},"maxInputTokenIn":{"type":"string","minLength":1},"details":{"type":"object","properties":{"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retiringEntityString":{"type":"string"},"beneficiaryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"beneficiaryString":{"type":"string"},"retirementMessage":{"type":"string"},"beneficiaryLocation":{"type":"string"},"consumptionCountryCode":{"type":"string"},"consumptionPeriodStart":{"anyOf":[{"type":"string"},{"type":"number"}]},"consumptionPeriodEnd":{"anyOf":[{"type":"string"},{"type":"number"}]}},"additionalProperties":false}},"required":["action","chainId","inputToken","amount","carbonClass"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"data":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"chain":{"type":"string"},"transactions":{"type":"array","items":{"type":"object","properties":{"step":{"type":"string"},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"value":{"type":"string"},"data":{"type":"string","pattern":"^0x[a-fA-F0-9]*$"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]}},"required":["step","to","value","data","chainId"],"additionalProperties":false}},"quote":{"type":"object","properties":{"tonnes":{"type":"string"},"tonnesFormatted":{"type":"string"},"retirementPrice":{"type":"string"},"retirementPriceFormatted":{"type":"string"},"fee":{"type":"string"},"feeFormatted":{"type":"string"},"total":{"type":"string"},"totalFormatted":{"type":"string"},"suggestedMaxInput":{"type":"string"},"suggestedMaxInputFormatted":{"type":"string"},"pricePerTonne":{"type":"string"},"pricePerTonneFormatted":{"type":"string"},"maxUsdcPricePerTonne":{"type":"string"},"maxUsdcPricePerTonneFormatted":{"type":"string"},"inputTokenSymbol":{"type":"string"},"inputTokenDecimals":{"type":"number"},"slippageBps":{"type":"number"},"humanSummary":{"type":"string"}},"required":["tonnes","tonnesFormatted","retirementPrice","retirementPriceFormatted","fee","feeFormatted","total","totalFormatted","suggestedMaxInput","suggestedMaxInputFormatted","pricePerTonne","pricePerTonneFormatted","maxUsdcPricePerTonne","maxUsdcPricePerTonneFormatted","inputTokenSymbol","inputTokenDecimals","slippageBps","humanSummary"],"additionalProperties":false},"approvalRequired":{"type":"boolean","const":true},"approvalInstructions":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amount":{"type":"string"},"amountFormatted":{"type":"string"},"note":{"type":"string"}},"required":["token","spender","amount","amountFormatted","note"],"additionalProperties":false}},"required":["to","data","chainId","chain","transactions","quote","approvalRequired","approvalInstructions"],"additionalProperties":false}},{"name":"prepare-auth","fee":"0","description":"Build the EIP-712 authorization a caller signs for a relayed retirement: returns typedData (EIP-3009 for USDC, EIP-2612 permit for kVCM) plus a ready-to-send actionsRetireRequest. Sign typedData, fill authPayload.{v,r,s}, then POST actions/retire. Off-chain only. GET alias: /api/prepare-auth.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"prepare-auth"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"inputToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amount":{"type":"string","minLength":1},"carbonClass":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"vintage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokenId":{"type":"string","minLength":1},"maxInputTokenIn":{"type":"string","minLength":1},"details":{"type":"object","properties":{"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retiringEntityString":{"type":"string"},"beneficiaryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"beneficiaryString":{"type":"string"},"retirementMessage":{"type":"string"},"beneficiaryLocation":{"type":"string"},"consumptionCountryCode":{"type":"string"},"consumptionPeriodStart":{"anyOf":[{"type":"string"},{"type":"number"}]},"consumptionPeriodEnd":{"anyOf":[{"type":"string"},{"type":"number"}]}},"additionalProperties":false},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"timeToLiveSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":86400}},"required":["action","chainId","inputToken","amount","carbonClass","from"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"scheme":{"type":"string","enum":["eip3009","eip2612"]},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"chain":{"type":"string"},"inputToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"spender":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"authValue":{"type":"string"},"authValueFormatted":{"type":"string"},"executorGas":{"type":"string"},"executorGasFormatted":{"type":"string"},"quote":{"type":"object","properties":{"tonnes":{"type":"string"},"tonnesFormatted":{"type":"string"},"retirementPrice":{"type":"string"},"retirementPriceFormatted":{"type":"string"},"fee":{"type":"string"},"feeFormatted":{"type":"string"},"total":{"type":"string"},"totalFormatted":{"type":"string"},"suggestedMaxInput":{"type":"string"},"suggestedMaxInputFormatted":{"type":"string"},"pricePerTonne":{"type":"string"},"pricePerTonneFormatted":{"type":"string"},"maxUsdcPricePerTonne":{"type":"string"},"maxUsdcPricePerTonneFormatted":{"type":"string"},"inputTokenSymbol":{"type":"string"},"inputTokenDecimals":{"type":"number"},"slippageBps":{"type":"number"},"humanSummary":{"type":"string"}},"required":["tonnes","tonnesFormatted","retirementPrice","retirementPriceFormatted","fee","feeFormatted","total","totalFormatted","suggestedMaxInput","suggestedMaxInputFormatted","pricePerTonne","pricePerTonneFormatted","maxUsdcPricePerTonne","maxUsdcPricePerTonneFormatted","inputTokenSymbol","inputTokenDecimals","slippageBps","humanSummary"],"additionalProperties":false},"resolvedCredit":{"type":"object","properties":{"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"tokenId":{"type":"number"},"vintage":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["creditToken","tokenId","vintage"],"additionalProperties":false},"typedData":{"type":"object","properties":{"domain":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"types":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string"}},"required":["name","type"],"additionalProperties":false}}},"primaryType":{"type":"string"},"message":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["domain","types","primaryType","message"],"additionalProperties":false},"actionsRetireRequest":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"onChainDetails":{"type":"object","properties":{"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retiringEntityString":{"type":"string"},"beneficiaryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"beneficiaryString":{"type":"string"},"retirementMessage":{"type":"string"},"beneficiaryLocation":{"type":"string"},"consumptionCountryCode":{"type":"string"},"consumptionPeriodStart":{"type":"string"},"consumptionPeriodEnd":{"type":"string"}},"required":["retiringAddress","retiringEntityString","beneficiaryAddress","beneficiaryString","retirementMessage","beneficiaryLocation","consumptionCountryCode","consumptionPeriodStart","consumptionPeriodEnd"],"additionalProperties":false},"note":{"type":"string"},"x402FacilitatorVersion":{"type":"number"}},"required":["scheme","chainId","chain","inputToken","spender","authValue","authValueFormatted","executorGas","executorGasFormatted","quote","resolvedCredit","typedData","actionsRetireRequest","onChainDetails","note","x402FacilitatorVersion"],"additionalProperties":false}},{"name":"actions/retire","fee":"variable","description":"Relay a caller-signed authorization on-chain (non-custodial: funds go directly to the settlement contract, the service only relays) and return the retirement certificate. Cost is the live retirement price + on-chain protocol fee + executor gas, all funded by the signed authorization. Omit authPayload to receive a 402 challenge (the authorization to sign, same shape as prepare-auth); include the signed authPayload to execute.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"actions/retire"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"inputToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"amount":{"type":"string","minLength":1},"carbonClass":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"creditToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"vintage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"tokenId":{"type":"string","minLength":1},"maxInputTokenIn":{"type":"string","minLength":1},"details":{"type":"object","properties":{"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"retiringEntityString":{"type":"string"},"beneficiaryAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"beneficiaryString":{"type":"string"},"retirementMessage":{"type":"string"},"beneficiaryLocation":{"type":"string"},"consumptionCountryCode":{"type":"string"},"consumptionPeriodStart":{"anyOf":[{"type":"string"},{"type":"number"}]},"consumptionPeriodEnd":{"anyOf":[{"type":"string"},{"type":"number"}]}},"additionalProperties":false},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"timeToLiveSeconds":{"type":"integer","exclusiveMinimum":0,"maximum":86400},"authPayload":{"anyOf":[{"type":"object","properties":{"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"value":{"anyOf":[{"type":"string"},{"type":"number"}]},"validAfter":{"anyOf":[{"type":"string"},{"type":"number"}]},"validBefore":{"anyOf":[{"type":"string"},{"type":"number"}]},"nonce":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]{130}$"},"v":{"type":"integer","minimum":0,"maximum":255},"r":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"s":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},"required":["from","to","value","validAfter","validBefore","nonce"],"additionalProperties":false},{"type":"object","properties":{"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"value":{"anyOf":[{"type":"string"},{"type":"number"}]},"deadline":{"anyOf":[{"type":"string"},{"type":"number"}]},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]{130}$"},"v":{"type":"integer","minimum":0,"maximum":255},"r":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"s":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}},"required":["from","to","value","deadline"],"additionalProperties":false}]}},"required":["action","chainId","inputToken","amount","carbonClass","from"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","enum":["settled","pending_index"]},"transactionHash":{"type":"string"},"chainId":{"anyOf":[{"type":"number","const":8453},{"type":"number","const":84532}]},"chain":{"type":"string"},"quote":{"type":"object","properties":{"tonnes":{"type":"string"},"tonnesFormatted":{"type":"string"},"retirementPrice":{"type":"string"},"retirementPriceFormatted":{"type":"string"},"fee":{"type":"string"},"feeFormatted":{"type":"string"},"total":{"type":"string"},"totalFormatted":{"type":"string"},"suggestedMaxInput":{"type":"string"},"suggestedMaxInputFormatted":{"type":"string"},"pricePerTonne":{"type":"string"},"pricePerTonneFormatted":{"type":"string"},"maxUsdcPricePerTonne":{"type":"string"},"maxUsdcPricePerTonneFormatted":{"type":"string"},"inputTokenSymbol":{"type":"string"},"inputTokenDecimals":{"type":"number"},"slippageBps":{"type":"number"},"humanSummary":{"type":"string"}},"required":["tonnes","tonnesFormatted","retirementPrice","retirementPriceFormatted","fee","feeFormatted","total","totalFormatted","suggestedMaxInput","suggestedMaxInputFormatted","pricePerTonne","pricePerTonneFormatted","maxUsdcPricePerTonne","maxUsdcPricePerTonneFormatted","inputTokenSymbol","inputTokenDecimals","slippageBps","humanSummary"],"additionalProperties":false},"retirementCount":{"type":"number"},"retirements":{"type":"array","items":{"type":"object","properties":{"retirementId":{"type":"string"},"retirementIndex":{"type":"number"},"certificateUrl":{"type":"string"},"amountInTonnes":{"type":"string"},"beneficiaryName":{"type":"string"},"beneficiaryLocation":{"type":"string"},"message":{"type":"string"},"projectId":{"type":"string"},"creditId":{"type":"string"},"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"timestamp":{"type":"number"}},"required":["retirementId","retirementIndex","certificateUrl","amountInTonnes","beneficiaryName","beneficiaryLocation","message","projectId","creditId","retiringAddress","timestamp"],"additionalProperties":false}},"note":{"type":"string"},"x402FacilitatorVersion":{"type":"number"}},"required":["status","transactionHash","chainId","chain","quote","retirementCount","retirements","note","x402FacilitatorVersion"],"additionalProperties":false}},{"name":"certificate","fee":"0","description":"Resolve the Carbonmark retirement-certificate URL(s) for a broadcast retire transaction. Pass `txHash` (the retirement tx hash); returns one entry per retirement in that tx (a batch retire produces several), each with its `certificateUrl`. Pass the optional `index` to select a single retirement from a batch. GET alias: /api/certificate?txHash=0x...&index=0","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","const":"certificate"},"txHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"transactionHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"retirementIndex":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false,"required":["action"]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transactionHash":{"type":"string"},"retirementCount":{"type":"number"},"retirements":{"type":"array","items":{"type":"object","properties":{"retirementId":{"type":"string"},"retirementIndex":{"type":"number"},"certificateUrl":{"type":"string"},"amountInTonnes":{"type":"string"},"beneficiaryName":{"type":"string"},"beneficiaryLocation":{"type":"string"},"message":{"type":"string"},"projectId":{"type":"string"},"creditId":{"type":"string"},"retiringAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"timestamp":{"type":"number"}},"required":["retirementId","retirementIndex","certificateUrl","amountInTonnes","beneficiaryName","beneficiaryLocation","message","projectId","creditId","retiringAddress","timestamp"],"additionalProperties":false}}},"required":["transactionHash","retirementCount","retirements"],"additionalProperties":false}}]},{"url":"https://x402.klimalabs.com/api/health","method":"GET","description":"Liveness probe. Always 200, no payment required.","fee":"0"}]}