Quickstart

This guide will get you all set up and ready to use the 1ClickImpact API. We'll cover how to get started and make your first API request. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API.

Choose your environment

1ClickImpact provides two separate environments:

Environment

Base URL

Purpose

Cost

Sandbox

https://sandbox.1clickimpact.com

Testing and development

Free, no real impact

Production

https://api.1clickimpact.com

Creating real environmental impact

Billable based on usage

For testing purposes, it is recommended to use the sandbox environment (test mode). The requests made to this environment don't affect the live data. You are not charged since the impact requests are not fulfilled. Data in test mode gets erased after 30 days. To create an impact use the production environment (live mode). The requests made in the production environment create a real world impact and you get charged for it in the next invoice. This documentation provides examples to make requests using cURL, JavaScript, Python, Java and Go.

Making your first API request

After getting your API keys, you are ready to make your first call to the 1ClickImpact API. Let's verify your API setup by sending a request to the whoami endpoint, which confirms your API key is valid and returns basic account information.

Sandbox Request

GET
/v1/whoami
curl --location https://sandbox.1clickimpact.com/v1/whoami \
--header 'x-api-key: {SANDBOX API KEY}'

Production Request

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

Build with AI or MCP

Every page of this documentation is also published in machine-readable form, so you can hand the whole API to an AI coding assistant (Claude, Cursor, Copilot, ChatGPT) or wire it into an MCP client instead of reading the reference yourself.

  • llms.txt — a compact index of every endpoint, base URL, and key concept. Small enough to paste straight into a chat.
  • llms-full.txt — the complete reference, with request and response shapes for every endpoint.
  • openapi.yaml — the OpenAPI 3 specification. Feed it to a client generator, or point any OpenAPI-to-MCP bridge at it to expose the 1ClickImpact endpoints as callable tools in your MCP client.

Starter prompt

Paste this into your assistant to have it pull the reference and start integrating:

AI starter prompt

I want to integrate the 1ClickImpact Environmental Impact API into my project.

Full API reference: https://docs.1clickimpact.com/llms-full.txt
OpenAPI spec: https://docs.1clickimpact.com/openapi.yaml

Please fetch the reference above and help me integrate the API.

What's next?

Great, you're now made your first request to the API. Here are a few links that might be handy as you venture further into the 1ClickImpact API: