# 1ClickImpact Environmental Impact API

> REST API for programmatic environmental impact - tree planting, ocean cleanup, carbon capture, and charitable donations. Integrate sustainability into any product in minutes. Last verified 2026-06-25.

## Base URLs
- Production: https://api.1clickimpact.com
- Sandbox: https://sandbox.1clickimpact.com (free, no real-world impact)

## Authentication
All requests require an `x-api-key` header. Obtain your API key from your 1ClickImpact dashboard.

## Docs Home
- [Full API Documentation](https://docs.1clickimpact.com)
- [Quickstart Guide](https://docs.1clickimpact.com/quickstart)
- [Authentication](https://docs.1clickimpact.com/authentication)
- [SDKs](https://docs.1clickimpact.com/sdks)
- [Errors](https://docs.1clickimpact.com/errors)
- [Pagination](https://docs.1clickimpact.com/pagination)

## Action Endpoints (POST)
- [Plant Trees](https://docs.1clickimpact.com/plant-trees) - POST /v1/plant_tree - Plant trees for your org or on behalf of customers
- [Clean Ocean](https://docs.1clickimpact.com/clean-ocean) - POST /v1/clean_ocean - Remove ocean plastic waste (amount in lbs)
- [Capture Carbon](https://docs.1clickimpact.com/capture-carbon) - POST /v1/capture_carbon - Offset CO2 emissions (amount in lbs)
- [Donate Money](https://docs.1clickimpact.com/donate-money) - POST /v1/donate_money - Make charitable donations (amount in cents). Supports optional `category` to tag donations with a cause (veterans, animals, hunger, education, climate, water, healthcare, housing, youth, disaster)
- [Cancel Impact](https://docs.1clickimpact.com/cancel-impact) - POST /v1/cancel_impact - Cancel and reverse a previously created impact (for refund flows). Requires `user_id` and `time_utc`. Optional `reason` (max 200 chars). Idempotent. Cancelled impacts are not charged.

## Analysis Endpoints (GET)
- [Website Carbon](https://docs.1clickimpact.com/website-carbon) - GET /v1/carbon - Calculate CO2 emissions per page view for any website URL. Returns carbon rating (A+ to F), green hosting status, transfer size, and energy statistics. Uses Sustainable Web Design Model V4. Results cached for 7 days. Each call counts as 2 API calls.

## Free Tools
- [Website Carbon Calculator](https://1clickimpact.com/website-carbon) - Free tool to check any website's carbon footprint. Enter a URL and get an instant carbon rating, CO2 per page view, green hosting status, and annual impact equivalents.
- [How It Works](https://1clickimpact.com/website-carbon/how-it-works) - Methodology explanation: data transfer measurement, green hosting verification, SWDM V4 calculation, and A+ to F rating system. Includes FAQs.

## Data Endpoints (GET)
- [WhoAmI](https://docs.1clickimpact.com/whoami) - GET /v1/whoami - Verify API key and retrieve account details
- [Impact](https://docs.1clickimpact.com/impact) - GET /v1/impact - Aggregated lifetime impact totals (own + customer breakdown)
- [Daily Impact](https://docs.1clickimpact.com/impact) - GET /v1/impact/daily - Time-series daily impact data with optional date range filtering
- [Records](https://docs.1clickimpact.com/records) - GET /v1/records - Your organization's full impact history
- [Customer Records](https://docs.1clickimpact.com/records) - GET /v1/customer_records - Per-customer impact history
- [Customers](https://docs.1clickimpact.com/customers) - GET /v1/customers - List all onboarded customers
- [Track](https://docs.1clickimpact.com/track) - GET /v1/track - Real-time lifecycle tracking for a specific impact event. Includes `cancelled_on` and `cancellation_reason` for cancelled impacts, and `donation_category` for categorized donations
- [Projects](https://docs.1clickimpact.com/projects) - GET /v1/projects - Browse all verified environmental impact projects (filter by type: trees, ocean, carbon)
- [Project](https://docs.1clickimpact.com/projects) - GET /v1/projects/:project_id - Full details for a single project including SDG alignments, images, location, and localized content

## Key Concepts
- Impact can be created for your org OR on behalf of customers using `customer_email` in the request body
- `user_id` and `time_utc` required for /v1/track can come from the POST action response (plant_tree, clean_ocean, capture_carbon, donate_money) OR from /v1/records / /v1/customer_records
- Sandbox environment is free and does not create real-world impact; safe for testing
- Trees: unit = number of trees | Ocean/Carbon: unit = lbs | Donations: unit = smallest currency unit (cents for USD)
- Use `filter_by` query param on /v1/records: tree_planted | waste_removed | carbon_captured | money_donated
- Pagination uses cursor-based approach: `limit` + `start_date` query params, follow `next_cursor` in response
- All POST action endpoints accept an optional `metadata` object (string -> string key-value pairs, max 20 pairs, key <= 40 chars, value <= 500 chars; reserved keys `gift` and `widgetID` not allowed). Returned on records that were created with metadata.

## Related Resources (AI / LLM index files)
- Main site: https://1clickimpact.com/llms.txt and https://1clickimpact.com/llms-full.txt
- Shopify app help: https://help.1clickimpact.com/llms.txt
- This API reference: https://docs.1clickimpact.com/llms.txt and https://docs.1clickimpact.com/llms-full.txt