> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GoodAPI: Plant Trees

> Plant and track trees through GoodAPI's standalone API, retrieve planting evidence, issue eligible tree refunds, and access the organization's impact dashboard.

![GoodAPI: Plant Trees logo](https://mintcdn.com/composio-preview/GL28i3tBlbEbBd-f/images/toolkits/goodapi_plant_trees.svg?fit=max\&auto=format\&n=GL28i3tBlbEbBd-f\&q=85\&s=bfccda8669fac096cf6d7fe39f028b74)

* **Category:** ecommerce
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `GOODAPI_PLANT_TREES`
* **Version:** 20261030\_00

## Tools

> [accordion] Create Tree Planting
>
> **Slug:** `GOODAPI_PLANT_TREES_CREATE_TREE_PLANTING`
>
> Create a metered tree-planting registration; live API keys can incur charges. Reuse the same idempotency key only when retrying the identical planting.
>
> #### Input Parameters
>
> **count** `integer` *required*
>
> Number of trees to plant; must be at least 1.
>
> **metadata** `object`
>
> Optional JSON metadata for non-sensitive correlation data; do not include personal, payment, or secret values.
>
> **attribution** `string`
>
> Optional non-sensitive label for attributing this planting in later reports and filters.
>
> **idempotency\_key** `string` *required*
>
> Stable unique key for this exact planting. Reuse it for an identical retry and never reuse it for a different planting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Aggregate Planting Evidence
>
> **Slug:** `GOODAPI_PLANT_TREES_GET_AGGREGATE_PLANTING_EVIDENCE`
>
> Return global tree-planting verification totals and field evidence grouped by region. The data is cached for 30 days, can contain a large media list, and is not limited to the connected organization's contributions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Impact Dashboard URL
>
> **Slug:** `GOODAPI_PLANT_TREES_GET_IMPACT_DASHBOARD_URL`
>
> Return the connected organization's shareable public impact dashboard URL.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tree Planting Evidence
>
> **Slug:** `GOODAPI_PLANT_TREES_GET_TREE_PLANTING_EVIDENCE`
>
> Return the beta, 30-day-cached planting lifecycle and sanitized evidence for one registration. This timeline can remain after refund and does not prove that the registration is still active.
>
> #### Input Parameters
>
> **registration\_id** `string` *required*
>
> Tree-planting registration ID whose lifecycle evidence to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tree Plantings
>
> **Slug:** `GOODAPI_PLANT_TREES_LIST_TREE_PLANTINGS`
>
> Return tree-planting registrations and totals, optionally filtered by registration, attribution, date, or metadata. The provider returns all matches without pagination, so use filters for large histories.
>
> #### Input Parameters
>
> **end\_date** `string`
>
> Optional end date in YYYY-MM-DD format for the provider's date filter.
>
> **attribution** `string`
>
> Filter registrations by their attribution label.
>
> **created\_date** `string`
>
> Filter by creation date in YYYY-MM-DD format.
>
> **metadata\_json** `string`
>
> Optional JSON-encoded object used to match registration metadata; avoid personal or secret values.
>
> **registration\_id** `string`
>
> Return the tree planting with this registration ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Refund Tree Planting
>
> **Slug:** `GOODAPI_PLANT_TREES_REFUND_TREE_PLANTING`
>
> Irreversibly refund all or part of an eligible tree planting from the current billing cycle and reduce active totals. Omit count for a full refund; reuse the same idempotency key only for an identical retry.
>
> #### Input Parameters
>
> **count** `integer`
>
> Number of trees to refund for a partial refund; omit to refund the full eligible registration.
>
> **reason** `string`
>
> Optional non-sensitive reason for the refund.
>
> **metadata** `object`
>
> Optional JSON metadata for non-sensitive refund correlation; do not include personal, payment, or secret values.
>
> **idempotency\_key** `string` *required*
>
> Stable unique key for this exact refund. Reuse it for an identical retry and never reuse it for a different refund.
>
> **registration\_id** `string` *required*
>
> ID of the tree-planting registration to refund.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
