# 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.

## 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 CO₂ emissions (amount in lbs)
- [Donate Money](https://docs.1clickimpact.com/donate-money) — POST /v1/donate_money — Make charitable donations (amount in cents)

## 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

## 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