API Documentation

Complete guide to integrating carbon offsetting.

Quick start

Get started with the Minpact API in minutes.

Base URL

https://minpact.com/v1

Authentication

Authorization: Bearer {your-api-key}

Get Your API Key

Endpoints

Pricing

Offsets

Interactive API Tester

Test endpoints live with real API calls

Get Current EUA Price

GET /api/v1/pricing

Public endpoint - Get real-time EU Allowance pricing information

Retrieve the current price per ton of CO₂ for EU Allowances (EUAs), including pricing tiers and market information. This endpoint is public and doesn't require authentication.

No Parameters Required

This endpoint doesn't require any parameters. Simply make a GET request to retrieve current pricing.

Response

{
  "price_per_ton": 76.64,
  "currency": "EUR",
  "last_updated": "2025-10-01",
  "minimum_purchase": 0.005
}

Response Fields

price_per_ton: Current price per ton of CO₂ in EUR
currency: Currency code (always "EUR")
last_updated: Date of last price update (YYYY-MM-DD format, always first of month)
minimum_purchase: Minimum amount in tons (0.005 = 5kg)

Example Usage

curl -X GET 'https://minpact.com/api/v1/pricing' \
  -H 'Accept: application/json'

💡 Integration Tip

Use this endpoint to display current pricing in your application or to calculate estimated costs before creating offsets. The price is fixed per ton regardless of volume.

Error Responses

400 Bad Request

{
  "success": false,
  "error": "validation_failed",
  "message": "Invalid input data",
  "details": {
    "co2_tons": ["The co2_tons field is required."],
    "name": ["The name field must be at least 3 characters."]
  }
}

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."
}