# GoodAPI

> GoodAPI is a REST API for adding real-world social and environmental impact
> to any software product. Plant trees, restore mangroves and kelp forests,
> rescue ocean-bound plastic, or donate to verified charities after any
> customer event — a purchase, a subscription, a review. We handle the
> partner routing, verification, and billing; you make one API call.

The base URL of the API is `https://app.thegoodapi.com`. Authentication is a
single header: `Authorization: <api_key>`. Every account ships with a
production key and a test key; the test key behaves identically but costs
nothing and creates no real-world impact.

A Cloudflare-hosted content-negotiation layer serves the plain-Markdown
source of most pages on request — either send `Accept: text/markdown` or
append `?format=md` to any URL on `www.thegoodapi.com` listed below.

## Machine-readable API spec

- [OpenAPI 3.1 spec](https://app.thegoodapi.com/openapi.json): full structured API definition — use this for generating clients, tool schemas, or MCP servers

## API reference

- [Introduction & authentication](https://www.thegoodapi.com/docs/api/): API keys, billing, and how the test/production keys differ
- [Planting trees](https://www.thegoodapi.com/docs/api/planting-trees/): `POST /plant/trees`, `GET /plant/trees`, `GET /evidence/tree/<treeid>` — plant trees, read totals, and get specific tree evidence
- [Planting trees — FAQ](https://www.thegoodapi.com/docs/api/planting-trees-faq/): planting sites, species, survival rates, verification
- [Ocean-bound plastic](https://www.thegoodapi.com/docs/api/ocean-bound-plastic/): `POST /rescue/plastic_bottles`, `GET /rescue/plastic_bottles` — rescue plastic bottles and read totals
- [Charity donations](https://www.thegoodapi.com/docs/api/charity-donations/): `GET /charities/search`, `POST /charities/donate`, `GET /charities/donations`, `POST /charities/subscribe`. Open to any app, not just Shopify. Lead plan is $49/month for API access. Funds flow (path only): we collect via Stripe; funds go through Our Change Foundation, a 501(c)(3) that grants to nonprofits; we name your platform in the grant info; we pay out monthly on the 28th; you get the tax receipt. Nonprofit receive timing depends on grantor portal settings. Nonprofits get a dashboard and CA AB 488 reports. Fees (separate): GoodAPI charges no donation processing fees and takes no cut of the donation. Donation costs are the Lead plan at $49/month for API access, Stripe collection (about 2 to 3 percent for cards, or about 0.8 percent for ACH if set up), and the foundation's 1.9% grant fee (to them, not GoodAPI). Example: collect $100, receipt $97 after card fees, nonprofit $95.10 after the grant fee. Each API call names a nonprofit by EIN or nonprofit ID from 1.3M+ verified 501(c)(3)s. Milestone or staged grant release is not supported. Tagging is supported via attribution plus metadata. Company-funded gifts may be aggregated internally into one donation per nonprofit periodically. Before you go live: required disclosure, CCV facts (6 entity registrations: Alabama, California, Hawaii, Massachusetts, Mississippi, South Carolina), Brand Partner coverage under GoodAPI's Our Change Foundation agreement (no separate CA/HI filing), and a compliance-pack request are documented on that page.
- [Manual contributions](https://www.thegoodapi.com/docs/api/manual-contributions/): `GET /evidence` — retrieve aggregated verification evidence
- [Widgets & badges](https://www.thegoodapi.com/docs/api/widgets-and-badges/): drop-in UI components for displaying impact
- [Public dashboard](https://www.thegoodapi.com/docs/api/public-dashboard/): `GET /dashboard_url` — share a live impact dashboard
- [Refunds](https://www.thegoodapi.com/docs/api/refunds/): `POST /refund/trees`, `POST /refund/plastic_bottles`, `POST /refund/donations`

## Product & pricing

- [How it works](https://www.thegoodapi.com/how-it-works/): the five-step flow from customer purchase → verified impact
- [Impact API](https://www.thegoodapi.com/impact-api/): REST API landing for trees, plastic, and charity donations, including funds flow, CCV, disclosure copy, and Lead-plan pricing
- [Tree Planting API](https://www.thegoodapi.com/tree-planting-api/): dedicated tree-planting REST API. Verified trees via Veritree GPS, from $0.43/tree, no monthly fee on tree usage, free test mode. Shopify app plus any platform
- [Donations](https://www.thegoodapi.com/donations/): Shopify checkout donations. CCV: all 50 states require a for-profit/nonprofit agreement; 39 require that agreement registered and GoodAPI is registered in all 39; 6 also require GoodAPI entity registration (Alabama, California, Hawaii, Massachusetts, Mississippi, South Carolina; done). Brand Partners, including API platforms, are covered by GoodAPI's Our Change Foundation agreement and do not need to file separately for California or Hawaii. California public profile: https://ca-rcf.evokeplatform.com/app/publicPortal/entityDetails/6659246
- [Pricing](https://www.thegoodapi.com/pricing/): per-unit pricing for mangroves, kelp, plastic collection, and arbor trees. Charity donations API access is $49/month on the Lead plan. GoodAPI charges no donation processing fees and takes no cut of the donation. GoodAPI covers state fees, bonds, and filings. Only other donation costs: Stripe collection fees and a 1.9% grant fee (to the foundation, not GoodAPI). No minimum commitment, no cancellation limits
- [Integrations](https://www.thegoodapi.com/integrations/): Shopify, Klaviyo, Shopify Flow, Growave, Loyalty Lion, Smile.io
- [Shopify app](https://www.thegoodapi.com/shopify/): the merchant-facing install flow
- [Our projects](https://www.thegoodapi.com/our-projects/): the reforestation, marine, and plastic-rescue projects customers can route to
- [Partners](https://www.thegoodapi.com/partners/): verification and delivery partners (veritree, Eden Reforestation, etc.)
- [Partner program](https://www.thegoodapi.com/partners/program/): affiliate, app, agency, and nonprofit partnership inquiries (email contact@thegoodapi.com)
- [About](https://www.thegoodapi.com/about/): company, founder story, and mission
- [Case study — Atari](https://www.thegoodapi.com/case-studies/atari/): how Atari plants trees per order with GoodAPI
- [Case study — Wheelyshop](https://www.thegoodapi.com/case-studies/wheelyshop/): how Wheelyshop plants a mangrove with every order and passed 11,000 trees

## Help center (Shopify)

- [How to accept collaborator access requests](https://www.thegoodapi.com/help/shopify/how-to-accept-collaborator-access-requests/)
- [How to change tree-planting site in the app](https://www.thegoodapi.com/help/shopify/how-to-change-tree-planting-site-in-the-app/)
- [How to display the Sprout badge in cart drawer](https://www.thegoodapi.com/help/shopify/how-to-display-the-sprout-badge-in-cart-drawer/)
- [How to add the GoodAPI footer badge](https://www.thegoodapi.com/help/shopify/how-to-add-the-goodapi-footer-badge/)
- [How to add badges to checkout, thank-you, and order-status pages](https://www.thegoodapi.com/help/shopify/how-to-add-badges-to-checkout-thank-you-and-order-status-page/)
- [How to add badges to thank-you and order-status pages](https://www.thegoodapi.com/help/shopify/how-to-add-badges-to-thank-you-and-order-status-page/)
- [How to add the home-page public banner](https://www.thegoodapi.com/help/shopify/how-to-add-the-home-page-public-banner/)
- [How to use Design Packs to create a counter and sustainability page](https://www.thegoodapi.com/help/shopify/how-to-use-design-packs-to-create-a-counter-and-sustainability-page/)
- [How to display your impact with GoodAPI metafields](https://www.thegoodapi.com/help/shopify/how-to-display-your-impact-with-goodapi-metafields/)
- [How to set custom impact per variant](https://www.thegoodapi.com/help/shopify/how-to-set-custom-impact-per-variant/)
- [How to plant trees only for reviews](https://www.thegoodapi.com/help/shopify/how-to-plant-trees-only-for-reviews/)
- [Setting up donations](https://www.thegoodapi.com/help/shopify/how-to-set-up-donations/)
- [How to hide the Sprout tree-planting product from your store](https://www.thegoodapi.com/help/shopify/how-to-hide-sprout-tree-planting-product-from-showing-in-your-store/)
- [How to offset your website's carbon footprint](https://www.thegoodapi.com/help/shopify/offset-your-websites-carbon-footprint/)
- [How to import a Shopify Flow file](https://www.thegoodapi.com/help/shopify/how-to-import-a-shopify-flow-file/)
- [How to use Shopify Flow to plant trees](https://www.thegoodapi.com/help/shopify/how-to-use-shopify-flow-to-plant-trees/)
- [List of Shopify Flows for planting trees](https://www.thegoodapi.com/help/shopify/list-of-shopify-flows-for-planting-trees/)
- [How to integrate GoodAPI with Klaviyo](https://www.thegoodapi.com/help/shopify/how-to-integrate-goodapi-with-klaviyo/)
- [Using GoodAPI events and data in Klaviyo](https://www.thegoodapi.com/help/shopify/using-goodapi-events-and-data-in-klaviyo/)
- [How to automatically send impact email after customer purchase via Klaviyo](https://www.thegoodapi.com/help/shopify/how-to-automatically-send-impact-email-after-customer-purchase-via-klaviyo/)
- [Using Growave Loyalty with GoodAPI to offer sustainability rewards](https://www.thegoodapi.com/help/shopify/using-growave-loyalty-with-goodapi-to-offer-sustainability-rewards/)
- [Using Loyalty Lion points for climate and social impact with GoodAPI](https://www.thegoodapi.com/help/shopify/using-loyalty-lion-points-for-climate-and-social-impact-with-goodapi/)
- [Using Smile.io points with GoodAPI to offer sustainability rewards](https://www.thegoodapi.com/help/shopify/using-smileio-points-with-goodapi-to-offer-sustainability-rewards/)
- [Preventing fraudulent orders of trees and plastic with GoodAPI](https://www.thegoodapi.com/help/shopify/preventing-fraudulent-orders-of-trees-and-plastic-with-goodapi/)

## Optional

- [Blog](https://www.thegoodapi.com/blog/): long-form posts on tree-planting APIs, ecommerce sustainability, greenwashing, and comparison guides
- [RSS feed](https://www.thegoodapi.com/rss.xml)
- [Sitemap](https://www.thegoodapi.com/sitemap-index.xml)
- [llms-full.txt](https://www.thegoodapi.com/llms-full.txt): the full text of every docs and help article concatenated into one file