API Documentation

Complete guide to integrating carbon offsetting.

Quick start

Get started with the Minpact API in minutes.

Base URL

https://api.minpact.com/v1

Authentication

Authorization: Bearer {your-api-key}

Get Your API Key

Endpoints

Offsets

Interactive API Tester

Test endpoints live with real API calls

Create Carbon Offset

POST /api/v1/offsets

Request Body

{
  "co2_tons": 0.1005,
  "emission_calculation_id": "calc_123456",
  "category": "business_travel",
  "comments": "Offsetting emissions from business trip to Berlin"
}

Response

{
  "success": true,
  "data": {
    "offset_id": "offset_789012",
    "certificate_number": "MINPACT-20250618-A1B2C3",
    "co2_tons": 0.1005,
    "total_amount": 8.60,
    "category": "business_travel",
    "comments": "Offsetting emissions from business trip to Berlin",
    "status": "pending",
    "created_at": "2025-06-18T15:30:00Z"
  }
}

Error Responses

400 Bad Request

{
  "success": false,
  "error": "validation_failed",
  "message": "Invalid input data",
  "details": {
    "origin": ["The origin field is required."]
  }
}

401 Unauthorized

{
  "success": false,
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

429 Too Many Requests

{
  "success": false,
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Try again in 60 seconds."
}