# 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.

## 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` — plant trees and read totals
- [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` (Early Access)
- [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`

## Product & pricing

- [How it works](https://www.thegoodapi.com/how-it-works/): the five-step flow from customer purchase → verified impact
- [Pricing](https://www.thegoodapi.com/pricing/): per-unit pricing for mangroves, kelp, plastic collection, agroforestry, and charity donations
- [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.)
- [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

## 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 environmental impact with GoodAPI metafields](https://www.thegoodapi.com/help/shopify/how-to-display-your-environmental-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/)
- [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