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