---
canonical_url: "https://docs.composio.dev/toolkits/digital_humani"
markdown_url: "https://docs.composio.dev/toolkits/digital_humani.md"
product: "platform"
version: null
last_updated: null
---

# Digital Humani

Digital Humani provides a reforestation API for browsing planting projects, submitting tree-planting requests, and tracking planted trees.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `DIGITAL_HUMANI`
- **Version:** 00000000_00

## Tools

### Get Current User and Enterprise

**Slug:** `DIGITAL_HUMANI_GET_CURRENT_USER_AND_ENTERPRISE`

Return the authenticated Digital Humani user and that user's enterprise details, including the enterprise ID needed by planting and reporting tools.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Enterprise Tree Count

**Slug:** `DIGITAL_HUMANI_GET_ENTERPRISE_TREE_COUNT`

Count trees for an enterprise across all time, one calendar month, or an inclusive date range. Omit all date selectors for the all-time total; otherwise provide either month or both start_date and end_date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | No | Calendar month to report in YYYY-MM format, such as 2026-08. Mutually exclusive with start_date and end_date. |
| `end_date` | string | No | Inclusive range end date in YYYY-MM-DD format. Supply it together with start_date and without month. |
| `start_date` | string | No | Inclusive range start date in YYYY-MM-DD format. Supply it together with end_date and without month. |
| `enterprise_id` | string | Yes | Opaque enterprise ID returned by Get Current User and Enterprise. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Reforestation Project

**Slug:** `DIGITAL_HUMANI_GET_PROJECT`

Return detailed information for one reforestation project, including whether it is active and its localized project fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Opaque project ID returned by List Reforestation Projects. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tree Request

**Slug:** `DIGITAL_HUMANI_GET_TREE_REQUEST`

Retrieve a tree-planting request by the UUID returned when it was created.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | Tree-request UUID returned by Plant Trees. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Tree Count

**Slug:** `DIGITAL_HUMANI_GET_USER_TREE_COUNT`

Count trees attributed to an exact end-user identifier within an enterprise.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user` | string | Yes | Exact end-user identifier used when the planting request was created, such as an email address. |
| `enterprise_id` | string | Yes | Opaque enterprise ID returned by Get Current User and Enterprise. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reforestation Projects

**Slug:** `DIGITAL_HUMANI_LIST_PROJECTS`

List reforestation project summaries and IDs. Call Get Reforestation Project to confirm a selected project is active before planting.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Plant Trees

**Slug:** `DIGITAL_HUMANI_PLANT_TREES`

CHARGEABLE PRODUCTION PURCHASE: create a real tree-planting request at $1 per tree. Use this tool only after the user explicitly authorizes the purchase and its exact tree_count; never use it for testing or infer a quantity.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user` | string | Yes | End-user identifier to attribute to the planting request, such as an email address or application user ID. |
| `project_id` | string | Yes | Active project ID selected from List Reforestation Projects. |
| `tree_count` | integer | Yes | Exact number of trees to purchase. Required with no default. The production API charges $1 per tree; use only after the user explicitly authorizes this purchase quantity. |
| `enterprise_id` | string | Yes | Opaque enterprise ID returned by Get Current User and Enterprise. This enterprise will be billed for the planting request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |