Impact

The Impact API provides two endpoints to track and showcase your environmental contributions over time. Use the aggregated endpoint to retrieve your total lifetime impact, or the daily endpoint to analyze impact trends over specific date ranges.

The aggregated endpoint returns consolidated totals with a breakdown between your direct impact (user_impact) and impact generated on behalf of your customers (customer_impact). The daily endpoint returns a time-series of impact data, allowing you to track daily progress and analyze patterns over time. Use this data to power dashboards, generate reports, or share real-time progress toward sustainability goals.

GET/v1/impact

Retrieve aggregated impact

This endpoint returns your total lifetime impact across all environmental categories, including a breakdown between direct impact and customer impact.

Response fields

Name
user_id
Type
string
Description
Your unique user identifier.
Name
tree_planted
Type
integer
Description
Total number of trees planted (user_impact + customer_impact).
Name
waste_removed
Type
integer
Description
Total amount of ocean waste removed in lbs (user_impact + customer_impact).
Name
carbon_captured
Type
integer
Description
Total amount of carbon captured in lbs (user_impact + customer_impact).
Name
money_donated
Type
integer
Description
Total amount donated in cents (user_impact + customer_impact).
Name
user_impact
Type
object
Description
Impact generated directly by your organization, containing tree_planted, waste_removed, carbon_captured, and money_donated fields.
Name
customer_impact
Type
object
Description
Impact generated on behalf of your customers, containing tree_planted, waste_removed, carbon_captured, and money_donated fields.

Request

GET

/v1/impact

curl --location 'https://api.1clickimpact.com/v1/impact' \
--header 'x-api-key: {PRODUCTION API KEY}'

Response

{
  "user_id": "U123",
  "tree_planted": 100,
  "waste_removed": 50,
  "carbon_captured": 75,
  "money_donated": 25000,
  "user_impact": {
    "tree_planted": 60,
    "waste_removed": 30,
    "carbon_captured": 45,
    "money_donated": 15000
  },
  "customer_impact": {
    "tree_planted": 40,
    "waste_removed": 20,
    "carbon_captured": 30,
    "money_donated": 10000
  }
}

GET/v1/impact/daily

Retrieve daily impact

This endpoint returns a time-series of your daily impact data. Use optional query parameters to filter by date range.

Optional query params

Name
start_date
Type
string
Description
The start date after which you want to query the impact records. The start_date should be in the format YYYY-MM-DD.
Name
end_date
Type
string
Description
The end date before which you want to query the impact records. The end_date should be in the format YYYY-MM-DD.

Response fields

Name
user_id
Type
string
Description
Your unique user identifier.
Name
daily_impact
Type
array
Description
Array of daily impact records, each containing:
- date (string): The date of the impact record in YYYY-MM-DD format
- tree_planted (integer): Number of trees planted on this day
- waste_removed (integer): Amount of ocean waste removed (in lbs) on this day
- carbon_captured (integer): Amount of carbon captured (in lbs) on this day
- money_donated (integer): Amount donated (in cents) on this day

Request

GET

/v1/impact/daily

curl --location 'https://api.1clickimpact.com/v1/impact/daily?start_date=2025-11-01&end_date=2025-11-30' \
--header 'x-api-key: {PRODUCTION API KEY}'

Response

{
  "user_id": "U123",
  "daily_impact": [
    {
      "date": "2025-11-15",
      "tree_planted": 5,
      "waste_removed": 0,
      "carbon_captured": 0,
      "money_donated": 0
    },
    {
      "date": "2025-11-21",
      "tree_planted": 0,
      "waste_removed": 10,
      "carbon_captured": 0,
      "money_donated": 500
    },
    {
      "date": "2025-11-30",
      "tree_planted": 2,
      "waste_removed": 0,
      "carbon_captured": 5,
      "money_donated": 0
    },
    {...},
    {...}
  ]
}