{"uid":"cap_UFtemw0_fRxWHj7a44Xg4","slug":"grove-consented-data-purchase-a9257fdc","name":"Grove Consented Data Purchase","description":"Grove consented-data pilot delivery. Requires an owner-enabled offer query parameter, the agreed license hash, and payment from its named buyer wallet. 25 data templates and 12 use types. One purchase per offer, 0.01 USDC to Grove Shared Fund. No personal records are exposed in discovery. Obtain an offer from its contributor before paying.","url":"https://grove.g-datalabs.com/api/data-purchase","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["offer","acceptLicense","licenseHash"],"properties":{"offer":{"type":"string","description":"Offer ID from the public catalog at https://grove.g-datalabs.com/api/data-offers or directly from its contributor."},"licenseHash":{"type":"string"},"acceptLicense":{"type":"boolean","const":true}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["service","license","output","payment"],"properties":{"output":{"type":"object"},"license":{"type":"object"},"payment":{"type":"object"},"service":{"const":"grove-consented-data"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f8d5R_RZk7hZvYeaW7KGw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase a consented dataset offer from the Grove data marketplace by submitting an offer ID, license acceptance, and payment.","exampleAgentPrompt":"I got an offer ID from a Grove data contributor — can you purchase that dataset for me? The offer ID is 'offer-abc-123', I accept the license, and the license hash is 'sha256-def456'.","exampleUseCases":[{"title":"Acquiring a consented demographic dataset","prompt":"I have a Grove offer ID 'offer-demo-789' from a contributor and the license hash 'sha256-abc123' — please purchase that consented dataset for me, I accept the license terms."},{"title":"Unlocking a market research data template","prompt":"Can you complete the Grove data purchase for offer ID 'offer-mkt-456' with license hash 'sha256-xyz789'? I accept the license and want to unlock that market research template."},{"title":"Automating a recurring data acquisition workflow","prompt":"Every time I receive a new Grove offer from my data contributor, I need you to automatically buy it — here's the latest one: offer ID 'offer-q3-2024', license hash 'sha256-qrs321', and I accept the license."}],"resultDescription":"Returns a JSON object containing the dataset output, license details (terms, hash, acceptance record), payment confirmation metadata, and a service identifier ('grove-consented-data') confirming the transaction completed.","failureModes":["Invalid or expired offer ID returns an error indicating the offer is not found or no longer active","Missing or incorrect licenseHash causes rejection of the purchase request","acceptLicense not set to true results in a validation error blocking the transaction","Insufficient funds or wrong buyer wallet causes payment failure","Attempting to purchase the same offer twice is blocked as only one purchase per offer is allowed","Offer not enabled by its owner/contributor returns an access denied or unavailable error"],"whenToPreferThis":"Use this endpoint when you have a specific consented data offer ID obtained directly from a contributor or the Grove catalog and need to complete a licensed, payment-gated data purchase. It is purpose-built for the Grove marketplace's one-purchase-per-offer model with USDC micropayment settlement. Prefer this over generic data APIs when data provenance, consent, and licensing compliance are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:30:21.757Z","isFirstParty":false}