Getting started with TheGoodAPI

Build something Good. Increase conversion.

Why use TheGoodAPI?

Through our api, you can seamlessly plant trees after any event in your app (subscription, product purchase, or any other customer milestone). Showcase your investment in our planet to your customers and drive more conversions.

Put tree planting on autopilot. No more manual tracking and payments. We plant trees on your behalf and invoice you once a month. We maintain an updated record of all the trees you have planted and provide certificates that show proof of tree planting.

Sign Up

POST https://app.thegoodapi.com/signup

A single signup method which will give you access to all the goodness with this API (right now only planting trees). During the beta, Invoices will be sent directly to email and will be payable from the email itself. No CC information needed to get started

Headers

Name	Type	Description
beta_token	string	Please DM @saifabid or @mirvise on twitter for a beta token to sign up with!

Request Body

Name	Type	Description
contact_name	string	Contact name, primarily used for communications and billing
email	string	Contact email, primarily used for billing
name	string	Organization Name

200 Two API Keys will be returned. Using the prod api_key will add the appropriate amount of trees to be charged on your end of month invoice. Using the.test keys will work exactly the same except you will not be.charged for the trees planted through these keys

{
  "api_key_prod": "xxxx",
  "api_key_test": "xxxx"
}

Note: During the beta, should you ever lose your keys or need a rotation, please send us a twitter DM @saifabid and we'll get it sorted out.

Plant Trees

POST https://app.thegoodapi.com/plant/trees

Yes, planting trees is really this easy!

Headers

Name	Type	Description
Authorization*	string	<API Key>

Request Body

Name	Type	Description
count	integer	The number of trees you'd like to plant

200

{
  "total_planted_trees": integer # Total number of trees planted in account lifetime
}

Please make sure to get an API Key from signing up first. To receive your beta_token, DM @saifabid twitter

Returns total trees planted

GET https://app.thegoodapi.com/plant/trees

Headers

Name	Type	Description
Authorization*	String	<API Key>

200: OK

{
  "total_planted_trees": int
}