Greencoin Carbon Credit Platform Documentation - Empowering Climate-Smart Agriculture

Introduction

Comprehensive API for registering farmers, estimating carbon reductions, and issuing tokenized carbon credits on ICP blockchain.

Welcome to the Carbon Credit Platform - a revolutionary system that empowers farmers to monetize their climate-smart agricultural practices. This documentation describes endpoints to manage farmer onboarding, carbon MRV (Monitoring, Reporting & Verification), and smart contract interactions for minting and tracking carbon credits.

Our platform leverages both direct field sampling and modeling-based MRV, integrated with ICP smart contracts, to transparently reward farmers for climate-smart practices. By combining cutting-edge technology with rigorous scientific standards, we're building a sustainable future for agriculture.

Platform Overview

Transforming agriculture through blockchain-verified carbon credits

5,000+ Expected Farmers Outreach

0.75M Tons CO₂ Sequestered

0.12M Hectares on Enrollement

$75,000 Output Farmer Payments

How It Works

1. Farmer Registration

Farmers register their land and agricultural practices through our secure platform, providing GPS coordinates, farm size, and current practices.

2. Monitoring & Verification

Advanced satellite monitoring, IoT sensors, and field sampling techniques track carbon sequestration and emission reductions.

3. Token Generation

Verified carbon reductions are converted to tradeable tokens on the ICP blockchain, providing transparent and immutable records.

4. Market Trading

Farmers can sell their carbon credits on our integrated marketplace or external platforms, generating additional income streams.

Benefits for Farmers

Discover how our platform creates value for agricultural communities

Financial Benefits

Additional Revenue Stream: Earn $15-50 per ton of CO₂ sequestered annually
Premium Pricing: Access to verified carbon credit markets with transparent pricing
Long-term Contracts: Multi-year agreements provide income stability
Performance Bonuses: Extra rewards for exceeding sequestration targets

Environmental Impact

Soil Health Improvement: Increased organic matter and water retention
Biodiversity Enhancement: Support for beneficial insects and wildlife
Water Quality Protection: Reduced runoff and nutrient leaching
Climate Resilience: Better adaptation to weather extremes

Success Story: Farmer John Kimani from Kiambu County increased his annual income by 35% while improving soil organic carbon by 2.1% over three years using cover cropping and reduced tillage practices.

Getting Started Guide

Step-by-step onboarding for new farmers

Eligibility Requirements

Farm size: Minimum 0.5 hectares, maximum 1,000 hectares
Location: Currently available in Kenya, Uganda, Tanzania, and Ghana
Land tenure: Valid ownership or long-term lease agreement (minimum 5 years)
Practice adoption: Commitment to implement eligible climate-smart practices
Baseline data: Willingness to participate in initial soil sampling and surveys

Onboarding Process

1

Application Submission

Complete online registration with farm details, GPS coordinates, and practice intentions.

2

Baseline Assessment

Field visit for soil sampling, practice verification, and establishment of baseline carbon levels.

3

Contract Agreement

Sign participation agreement outlining practices, monitoring requirements, and payment terms.

4

Implementation Support

Receive training, technical assistance, and initial resources to implement climate-smart practices.

Important: The onboarding process typically takes 4-6 weeks from application to active participation. Baseline measurements are crucial for accurate carbon credit calculations.

MRV Methods

Comprehensive Monitoring, Reporting & Verification systems

1. Direct Measurement (Field-Based)

Our gold-standard approach combines multiple measurement techniques for maximum accuracy:

🔬 Soil Sampling Protocol

Collect soil cores from representative plots using systematic grid sampling
Sample depths: 0-15cm, 15-30cm, and 30-45cm for comprehensive analysis
Laboratory analysis includes Soil Organic Carbon (SOC), bulk density, and pH
Sampling frequency: Baseline + annual monitoring for 5 years
Quality control: 10% duplicate samples and certified reference materials

🌳 Biomass Measurement

Tree diameter at breast height (DBH) and total height measurements
Species-specific allometric equations for accurate carbon estimates
Above-ground and below-ground biomass calculations
Canopy cover assessment using densiometer or mobile apps

📋 Activity Documentation

Detailed logs of tillage operations, fertilizer applications, and crop rotations
GPS-tagged photos of field conditions and practice implementation
Weather data integration from local meteorological stations
Mobile app for real-time data collection and farmer reporting

Challenges: High cost ($200-500 per farm), time-intensive field work, and logistical complexity in remote areas. Reserved for high-value projects and verification sampling.

2. Modeling-Based Estimation

Cost-effective scaling through validated models and remote sensing technology:

Tool/Method	Purpose	Accuracy	Cost
COMET-Farm	USDA-developed model for soil carbon and GHG emissions	±15-20%	Free
Cool Farm Tool	Global web calculator for farm-level carbon footprints	±20-25%	Free
EX-ACT	FAO carbon balance estimator for land use projects	±25-30%	Free
ALU Tool	Land use change and GHG emission analysis	±20%	Licensed
Satellite Analytics	NDVI, soil moisture, and vegetation monitoring	±10-15%	Moderate

🛰️ Remote Sensing Integration

Sentinel-2: 10m resolution for crop monitoring and land use verification
Landsat 8/9: Long-term historical analysis and change detection
Planet Labs: Daily 3m imagery for detailed practice verification
Soil moisture data: SMAP satellite integration for drought monitoring

Benefits: Highly scalable, cost-effective ($10-50 per farm), and enables real-time monitoring. Satellite data provides independent verification of farmer-reported activities.

3. Hybrid Approach

Our platform combines both methods for optimal cost-accuracy balance:

Tier 1 Farms (>100 hectares): Direct measurement with annual soil sampling
Tier 2 Farms (10-100 hectares): Modeling with periodic verification sampling
Tier 3 Farms (<10 hectares): Pure modeling approach with satellite monitoring
Quality Assurance: 5% random verification sampling across all tiers

Eligible Climate-Smart Practices

Approved agricultural practices for carbon credit generation

Cover Cropping

Plant cover crops during fallow periods to protect soil and sequester carbon.
Potential: 0.5-1.5 tons CO₂/ha/year
Payment: $25-40 per ton

No-Till/Reduced Tillage

Minimize soil disturbance to preserve soil structure and carbon.
Potential: 0.3-1.0 tons CO₂/ha/year
Payment: $20-35 per ton

Agroforestry

Integrate trees into agricultural systems for carbon storage and biodiversity.
Potential: 2.0-8.0 tons CO₂/ha/year
Payment: $30-50 per ton

Crop Rotation

Diversify crops to improve soil health and reduce emissions.
Potential: 0.2-0.8 tons CO₂/ha/year
Payment: $15-30 per ton

Composting

Use organic waste to create carbon-rich soil amendments.
Potential: 0.4-1.2 tons CO₂/ha/year
Payment: $20-35 per ton

Improved Irrigation

Efficient water management reduces energy use and emissions.
Potential: 0.1-0.5 tons CO₂/ha/year
Payment: $15-25 per ton

Combination Benefits: Farmers implementing multiple practices can achieve 3-12 tons CO₂/ha/year sequestration, potentially earning $150-600 per hectare annually from carbon credits alone.

Carbon Measurement & Calculation

Scientific methodologies for accurate carbon quantification

Measurement Standards

Our platform adheres to internationally recognized standards:

VCS (Verified Carbon Standard): Primary methodology for project validation
Gold Standard: Enhanced requirements for sustainable development co-benefits
ISO 14064: International standard for GHG quantification and reporting
IPCC Guidelines: 2006 IPCC Guidelines for National GHG Inventories

Carbon Pools Measured

Carbon Pool	Measurement Method	Frequency	Uncertainty
Soil Organic Carbon	Laboratory analysis (Walkley-Black method)	Annual	±5-10%
Above-ground Biomass	Allometric equations, drone imagery	Bi-annual	±10-15%
Below-ground Biomass	Root:shoot ratios, soil coring	Annual	±15-25%
Deadwood	Direct measurement, decay models	Annual	±20-30%
Litter	Quadrat sampling, dry weight	Seasonal	±15-20%

Calculation Methodology


// Carbon sequestration calculation example
function calculateCarbonSequestration(farmData) {
  const {
    soilCarbonChange,     // tons C/ha/year
    biomassGrowth,        // tons C/ha/year
    practiceEfficiency,   // 0.0 - 1.0
    leakageDiscount,      // 0.0 - 0.2
    buffer               // 0.1 - 0.3 (risk buffer)
  } = farmData;
  
  // Total carbon sequestration
  const totalSequestration = (soilCarbonChange + biomassGrowth) * practiceEfficiency;
  
  // Apply leakage discount
  const adjustedSequestration = totalSequestration * (1 - leakageDiscount);
  
  // Apply conservative buffer
  const finalSequestration = adjustedSequestration * (1 - buffer);
  
  // Convert to CO2 equivalent (multiply by 44/12)
  const co2Equivalent = finalSequestration * 3.67;
  
  return {
    totalSequestration,
    co2Equivalent,
    creditsGenerated: Math.floor(co2Equivalent * 100) / 100 // Round to 2 decimals
  };
}

Verification Process

Third-party validation and quality assurance

Verification Steps

1

Internal QA/QC

Automated data validation, outlier detection, and consistency checks across all measurements and farmer reports.

2

Field Verification

Random sampling of 10% of farms for independent verification by certified field technicians.

3

Satellite Cross-Check

Remote sensing validation of reported practices using high-resolution satellite imagery and AI analysis.

4

Third-Party Audit

Annual audits by VCS-accredited validation and verification bodies (VVBs) for final credit issuance.

Verification Bodies

VVB Partner	Specialization	Accreditation	Coverage
SCS Global Services	Agriculture & Forestry	VCS, Gold Standard, ISO 14065	Global
Bureau Veritas	Land Use & Agriculture	VCS, CDM, ISO 14065	Africa, Europe
SGS	Environmental Services	VCS, Gold Standard	Global
Control Union	Sustainable Agriculture	VCS, Fairtrade, Organic	Developing Countries

Verification Timeline: The complete verification process takes 4-8 weeks from data submission to credit issuance, with real-time status updates available through our API.

Data Models

TypeScript / Motoko interfaces for platform integration

Core Data Structures


// Farmer registration record
interface Farmer {
  id: Text;                    // Unique farmer identifier
  name: Text;                  // Full legal name
  location: Text;              // GPS coordinates (lat,lng)
  farmSize: Float;             // Area in hectares
  practices: [Text];           // Array of adopted practices
  registrationDate: Text;      // ISO 8601 timestamp
  verificationStatus: Text;    // "pending" | "verified" | "rejected"
  contactInfo: ContactInfo;
  landTenure: LandTenureInfo;
  baseline: BaselineData;
}

// Contact information
interface ContactInfo {
  phoneNumber: Text;
  email: ?Text;                // Optional email
  physicalAddress: Text;
  preferredLanguage: Text;     // "en" | "sw" | "fr" | etc.
  emergencyContact: Text;
}

// Land tenure documentation
interface LandTenureInfo {
  ownershipType: Text;         // "owned" | "leased" | "communal"
  documentNumber: Text;        // Title deed or lease agreement number
  expiryDate: ?Text;          // For leased land
  legalVerification: Bool;     // Document verification status
}

// Baseline carbon measurements
interface BaselineData {
  soilOrganicCarbon: Float;    // Percentage or tons/ha
  biomassCarbon: Float;        // tons C/ha
  measurementDate: Text;
  samplingPoints: [GPSPoint];
  labResults: [LabResult];
}

// Carbon estimate record
interface CarbonEstimate {
  id: Text;
  farmerId: Text;
  period: Text;                // "YYYY-MM-DD to YYYY-MM-DD"
  methodology: Text;           // "field-sampling" | "modeling" | "hybrid"
  co2eSequestered: Float;      // tons CO2 equivalent
  co2eAvoided: Float;          // tons CO2 equivalent from avoided emissions
  practicesImplemented: [Practice];
  confidence: Float;           // 0.0 - 1.0 confidence score
  verificationStatus: Text;
  timestamp: Text;
  calculationDetails: CalculationBreakdown;
}

// Practice implementation details
interface Practice {
  type: Text;                  // "cover-cropping" | "no-till" | etc.
  area: Float;                 // hectares covered
  implementationDate: Text;
  effectiveness: Float;        // 0.0 - 1.0 implementation quality
  evidence: [Evidence];        // Photos, GPS tracks, etc.
}

// Evidence documentation
interface Evidence {
  type: Text;                  // "photo" | "gps-track" | "receipt" | etc.
  url: Text;                   // IPFS hash or cloud storage URL
  timestamp: Text;
  gpsLocation: ?Text;
  description: Text;
}

// Credit transaction record
interface CreditTransaction {
  txId: Text;                  // Blockchain transaction ID
  farmerId: Text;
  amount: Float;               // Number of credits
  pricePerCredit: Float;       // USD per credit
  totalValue: Float;           // Total payment in USD
  walletAddress: Text;         // ICP wallet address
  status: Text;                // "pending" | "completed" | "failed"
  issuanceDate: Text;
  vintageYear: Nat;            // Year of carbon sequestration
  methodology: Text;
  serialNumbers: [Text];       // VCS registry serial numbers
}

// Marketplace listing
interface CreditListing {
  listingId: Text;
  sellerId: Text;              // Farmer or aggregator ID
  credits: [CreditBatch];
  pricePerCredit: Float;
  totalCredits: Float;
  description: Text;
  cobenefits: [Text];          // Additional sustainability benefits
  location: Text;              // Geographic origin
  certifications: [Text];      // VCS, Gold Standard, etc.
  listedDate: Text;
  status: Text;                // "active" | "sold" | "expired"
}

// Credit batch information
interface CreditBatch {
  batchId: Text;
  vintageYear: Nat;
  methodology: Text;
  quantity: Float;
  verificationBody: Text;
  projectId: Text;
  additionalityProof: Text;
}

Error Handling Types


// API Response wrapper
type ApiResponse = {
  success: Bool;
  data: ?T;
  error: ?ApiError;
  timestamp: Text;
  requestId: Text;
}

// Error types
type ApiError = {
  code: Text;                  // "FARMER_NOT_FOUND" | "INVALID_GPS" | etc.
  message: Text;
  details: ?Text;
  retryable: Bool;
}

// Validation result
type ValidationResult = {
  isValid: Bool;
  errors: [ValidationError];
  warnings: [ValidationWarning];
}

type ValidationError = {
  field: Text;
  code: Text;
  message: Text;
}

ICP Blockchain Integration

Decentralized canisters and token standards

Canister Architecture

Our platform deploys multiple specialized canisters for optimal performance and security:

FarmerManager

Handles farmer registration, profile management, and authentication. Stores encrypted personal data with privacy controls.

CarbonEstimator

Implements MRV logic, carbon calculations, and integrates with external APIs for satellite data and weather information.

TokenMinter

Manages ICRC-1 compliant $CARBON token minting, burning, and transfers. Includes escrow functionality for marketplace trades.

Marketplace

Facilitates peer-to-peer trading of carbon credits with automated matching, price discovery, and settlement.

Token Standard Implementation

Our $CARBON token implements the ICRC-1 standard for maximum compatibility:


// CARBON token canister (Motoko)
import ICRC1 "mo:icrc1";
import Principal "mo:base/Principal";
import Time "mo:base/Time";

actor CarbonToken = {
  
  // Token metadata
  private let TOKEN_NAME = "Carbon Credit Token";
  private let TOKEN_SYMBOL = "CARBON";
  private let TOKEN_DECIMALS = 8;
  private let TOKEN_FEE = 10_000; // 0.0001 CARBON
  
  // Minting authority (restricted to verified projects)
  private stable var minting_authority = Principal.fromText("rdmx6-jaaaa-aaaah-qcaiq-cai");
  
  // Carbon credit metadata for each token
  private stable var credit_metadata = Map.HashMap(0, Nat.equal, Hash.hash);
  
  type CreditMetadata = {
    vintageYear: Nat;
    methodology: Text;
    projectId: Text;
    verificationBody: Text;
    co2Equivalent: Float;
    issuanceDate: Int;
  };
  
  // Mint carbon credits (restricted function)
  public shared(msg) func mint_carbon_credits(
    to: ICRC1.Account,
    amount: Nat,
    metadata: CreditMetadata
  ) : async ICRC1.TransferResult {
    
    // Verify caller is authorized minting authority
    if (msg.caller != minting_authority) {
      return #Err(#Unauthorized { message = "Only minting authority can mint credits" });
    };
    
    // Store credit metadata
    credit_metadata.put(amount, metadata);
    
    // Mint tokens
    await ICRC1.mint({
      to = to;
      amount = amount;
      memo = ?Text.encodeUtf8("Carbon credit issuance: " # metadata.projectId);
      created_at_time = ?Nat64.fromNat(Int.abs(Time.now()));
    });
  };
  
  // Retire carbon credits (permanent removal from circulation)
  public shared(msg) func retire_credits(
    amount: Nat,
    retirement_reason: Text
  ) : async ICRC1.TransferResult {
    
    // Burn tokens to retirement address
    let retirement_account = { 
      owner = Principal.fromText("aaaaa-aa"); // Burn address
      subaccount = null 
    };
    
    await ICRC1.transfer({
      from_subaccount = null;
      to = retirement_account;
      amount = amount;
      fee = ?TOKEN_FEE;
      memo = ?Text.encodeUtf8("Credit retirement: " # retirement_reason);
      created_at_time = ?Nat64.fromNat(Int.abs(Time.now()));
    });
  };
  
  // Get credit metadata
  public query func get_credit_metadata(token_id: Nat) : async ?CreditMetadata {
    credit_metadata.get(token_id);
  };
  
  // Batch transfer for marketplace efficiency
  public shared(msg) func batch_transfer(
    transfers: [ICRC1.TransferArgs]
  ) : async [ICRC1.TransferResult] {
    
    var results: [ICRC1.TransferResult] = [];
    
    for (transfer_args in transfers.vals()) {
      let result = await ICRC1.transfer(transfer_args);
      results := Array.append(results, [result]);
    };
    
    results;
  };
};

Smart Contract Features

Fractional Ownership: Credits divisible to 8 decimal places for small-scale trading
Metadata Storage: On-chain storage of vintage year, methodology, and verification data
Retirement Mechanism: Permanent removal of credits from circulation when used
Batch Operations: Efficient batch transfers for marketplace and aggregator use
Access Controls: Role-based permissions for minting, verification, and governance
Audit Trail: Immutable transaction history for full transparency and compliance

Setup & Deployment

Local development and production deployment with DFX

Prerequisites

DFX SDK: Version 0.15.0 or higher
Node.js: Version 18.0+ for frontend development
Rust: Latest stable version for canister development
ICP Cycles: Minimum 10T cycles for mainnet deployment

Project Initialization


# Create new project
dfx new carbon-credit-platform --type=rust
cd carbon-credit-platform

# Initialize git repository
git init
git add .
git commit -m "Initial project setup"

# Install dependencies
npm install
cargo check

# Configure dfx.json for multiple canisters
cat > dfx.json << 'EOF'
{
  "version": 1,
  "canisters": {
    "farmer_manager": {
      "type": "rust",
      "package": "farmer_manager",
      "candid": "src/farmer_manager/farmer_manager.did"
    },
    "carbon_estimator": {
      "type": "rust", 
      "package": "carbon_estimator",
      "candid": "src/carbon_estimator/carbon_estimator.did"
    },
    "token_minter": {
      "type": "rust",
      "package": "token_minter", 
      "candid": "src/token_minter/token_minter.did"
    },
    "marketplace": {
      "type": "rust",
      "package": "marketplace",
      "candid": "src/marketplace/marketplace.did"
    },
    "frontend": {
      "type": "assets",
      "source": ["dist/"]
    }
  },
  "networks": {
    "local": {
      "bind": "127.0.0.1:8000",
      "type": "ephemeral"
    },
    "ic": {
      "providers": ["https://icp-api.io"],
      "type": "persistent"
    }
  }
}
EOF

Local Development


# Start local replica in background
dfx start --background --clean

# Deploy all canisters locally
dfx deploy --network local

# Check canister status
dfx canister status --all --network local

# Install frontend dependencies
cd src/frontend
npm install
npm run build
cd ../..

# Deploy frontend
dfx deploy frontend --network local

# Test API endpoints
dfx canister call farmer_manager register_farmer '(
  record {
    name = "John Kamau";
    location = "-1.2921,36.8219";
    farm_size = 5.5;
    practices = vec {"no-till"; "cover-cropping"};
  }
)'

Production Deployment


# Ensure you have cycles (minimum 10T for full deployment)
dfx wallet balance --network ic

# Deploy to IC mainnet (requires cycles)
dfx deploy --network ic --with-cycles 2000000000000

# Set up production environment variables
dfx canister call token_minter set_minting_authority '(
  principal "rdmx6-jaaaa-aaaah-qcaiq-cai"
)' --network ic

# Configure marketplace settings
dfx canister call marketplace configure '(
  record {
    platform_fee = 0.025; // 2.5% platform fee
    min_credit_price = 5.0; // $5 minimum per credit
    max_listing_duration = 7776000; // 90 days in seconds
  }
)' --network ic

# Verify deployment
dfx canister id --all --network ic

Environment Configuration

Create environment-specific configuration files:


// config/environments.ts
export const environments = {
  local: {
    DFX_NETWORK: 'local',
    FARMER_MANAGER_CANISTER: 'rrkah-fqaaa-aaaaa-aaaaq-cai',
    CARBON_ESTIMATOR_CANISTER: 'rno2w-sqaaa-aaaaa-aaacq-cai',
    TOKEN_MINTER_CANISTER: 'rdmx6-jaaaa-aaaah-qcaiq-cai',
    MARKETPLACE_CANISTER: 'renrk-eyaaa-aaaah-qcaoa-cai',
    SATELITE_API_KEY: 'dev_key_12345',
    WEATHER_API_KEY: 'weather_dev_key',
    IPFS_GATEWAY: 'https://ipfs.io/ipfs/',
  },
  production: {
    DFX_NETWORK: 'ic',
    FARMER_MANAGER_CANISTER: 'by6od-j4aaa-aaaah-qcaaa-cai',
    CARBON_ESTIMATOR_CANISTER: 'bw4dl-smaaa-aaaah-qcaaq-cai', 
    TOKEN_MINTER_CANISTER: 'br5f7-7uaaa-aaaah-qcaea-cai',
    MARKETPLACE_CANISTER: 'bs5l3-7iaaa-aaaah-qcaoa-cai',
    SATELITE_API_KEY: process.env.SATELITE_API_KEY,
    WEATHER_API_KEY: process.env.WEATHER_API_KEY,
    IPFS_GATEWAY: 'https://gateway.pinata.cloud/ipfs/',
  }
};

// Frontend integration
export const getConfig = () => {
  const network = process.env.DFX_NETWORK || 'local';
  return environments[network as keyof typeof environments];
};

Deployment Costs: Full mainnet deployment costs approximately 8-12T cycles (~$10-15 USD). Budget additional cycles for ongoing operation and storage.

Register Farmer

Enroll new farmers into the carbon credit program

POST /v1/farmers/register

Request Parameters

Parameter	Type	Description	Required
name	string	Farmer's full legal name (2-100 characters)	Yes
location	string	GPS coordinates in "lat,lng" format (WGS84)	Yes
farmSize	number	Farm area in hectares (0.5 - 1000.0)	Yes
practices	array	List of climate-smart practices to implement	Yes
phoneNumber	string	Mobile phone number with country code	Yes
email	string	Email address for notifications (optional)	No
language	string	Preferred language: "en", "sw", "fr", etc.	No
landTenure	object	Land ownership/lease documentation	Yes

Land Tenure Object

Field	Type	Description	Required
ownershipType	string	"owned", "leased", or "communal"	Yes
documentNumber	string	Title deed or lease agreement reference	Yes
expiryDate	string	Lease expiry date (YYYY-MM-DD) if applicable	No

Example Request


{
  "name": "Jane Wanjiku Doe",
  "location": "-1.2921,36.8219",
  "farmSize": 5.5,
  "practices": ["no-till", "agroforestry", "cover-cropping"],
  "phoneNumber": "+254712345678",
  "email": "jane.doe@example.com",
  "language": "en",
  "landTenure": {
    "ownershipType": "owned",
    "documentNumber": "NAIROBI/BLOCK12/567",
    "expiryDate": null
  }
}

Success Response (201 Created)


{
  "status": "success",
  "data": {
    "farmerId": "FARM12345",
    "registrationDate": "2025-07-25T10:30:00Z",
    "verificationStatus": "pending",
    "estimatedOnboardingTime": "4-6 weeks",
    "nextSteps": [
      "Document verification (2-3 days)",
      "Field assessment scheduling",
      "Baseline measurement appointment",
      "Training session enrollment"
    ]
  },
  "message": "Farmer registration successful. Verification process initiated."
}

Error Responses


// 400 Bad Request - Validation Error
{
  "status": "error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "farmSize": "Farm size must be between 0.5 and 1000 hectares",
      "location": "GPS coordinates must be within supported regions"
    }
  }
}

// 409 Conflict - Duplicate Registration
{
  "status": "error", 
  "error": {
    "code": "FARMER_EXISTS",
    "message": "Farmer already registered with this phone number",
    "details": "Existing farmer ID: FARM67890"
  }
}

// 422 Unprocessable Entity - Eligibility Issue
{
  "status": "error",
  "error": {
    "code": "ELIGIBILITY_FAILED",
    "message": "Farm does not meet program requirements",
    "details": "Location outside supported regions. Currently available in Kenya, Uganda, Tanzania, and Ghana."
  }
}

Estimate Carbon Sequestration

Calculate CO₂ equivalent reduction and sequestration potential

POST /v1/carbon/estimate

Request Parameters

Parameter	Type	Description	Required
farmerId	string	Registered farmer identifier	Yes
period	string	Estimation period (YYYY-MM-DD to YYYY-MM-DD)	Yes
methodology	string	"field-sampling", "modeling", or "hybrid"	No
practices	array	Specific practices to include in calculation	No
includeBaseline	boolean	Include baseline measurements in calculation	No

Example Request


{
  "farmerId": "FARM12345",
  "period": "2025-01-01 to 2025-12-31",
  "methodology": "hybrid",
  "practices": ["no-till", "agroforestry"],
  "includeBaseline": true
}

Success Response (200 OK)


{
  "status": "success",
  "data": {
    "estimationId": "EST78901",
    "farmerId": "FARM12345",
    "period": "2025-01-01 to 2025-12-31",
    "methodology": "hybrid",
    "results": {
      "totalCO2eSequestered": 12.3,
      "totalCO2eAvoided": 4.7,
      "netCO2eImpact": 17.0,
      "creditsEligible": 15.3,
      "confidenceScore": 0.85
    },
    "breakdown": {
      "soilCarbonSequestration": 8.2,
      "biomassCarbon": 4.1,
      "emissionReductions": 4.7,
      "buffer": 1.7,
      "leakageDiscount": 0.0
    },
    "practiceContributions": [
      {
        "practice": "no-till",
        "area": 3.0,
        "co2eContribution": 6.8,
        "confidence": 0.90
      },
      {
        "practice": "agroforestry", 
        "area": 2.5,
        "co2eContribution": 10.2,
        "confidence": 0.80
      }
    ],
    "monetaryValue": {
      "estimatedValue": 535.50,
      "priceRange": {
        "minimum": 459.00,
        "maximum": 612.00
      },
      "currency": "USD"
    },
    "generatedAt": "2025-07-25T10:45:00Z",
    "validUntil": "2025-08-25T10:45:00Z"
  }
}

Error Responses


// 404 Not Found - Farmer not registered
{
  "status": "error",
  "error": {
    "code": "FARMER_NOT_FOUND",
    "message": "Farmer ID not found in system",
    "retryable": false
  }
}

// 400 Bad Request - Invalid period
{
  "status": "error",
  "error": {
    "code": "INVALID_PERIOD",
    "message": "Period must be within current or future years only",
    "details": "Historical estimates require baseline data"
  }
}

Issue Carbon Credit Tokens

Mint verified carbon credits to farmer's ICP wallet

POST /v1/credits/issue

Request Parameters

Parameter	Type	Description	Required
farmerId	string	Verified farmer identifier	Yes
amount	number	Number of credits to issue (max 2 decimal places)	Yes
walletAddress	string	ICP principal ID or account identifier	Yes
vintageYear	number	Year of carbon sequestration (2020-2030)	Yes
methodology	string	Verification methodology used	Yes
projectId	string	Associated project identifier	No
verificationBody	string	Third-party verifier name	Yes

Example Request


{
  "farmerId": "FARM12345",
  "amount": 12.35,
  "walletAddress": "abcd-efgh-ijkl-mnop-qrst-uvwx-yz12-3456",
  "vintageYear": 2025,
  "methodology": "VCS-VM0017",
  "projectId": "KE-001-2025",
  "verificationBody": "SCS Global Services"
}

Success Response (201 Created)


{
  "status": "success",
  "data": {
    "transactionId": "TXN67890",
    "blockchainTxHash": "0x8f7e6d5c4b3a2918f7e6d5c4b3a2918f7e6d5c4b3a29",
    "tokensMinted": 12.35,
    "recipientWallet": "abcd-efgh-ijkl-mnop-qrst-uvwx-yz12-3456",
    "serialNumbers": [
      "KE-VCS-17-001-2025-001-12350000",
      "KE-VCS-17-001-2025-002-12350000"
    ],
    "metadata": {
      "vintageYear": 2025,
      "methodology": "VCS-VM0017",
      "projectId": "KE-001-2025",
      "verificationBody": "SCS Global Services",
      "issuanceDate": "2025-07-25T11:00:00Z",
      "co2Equivalent": 12.35
    },
    "fees": {
      "platformFee": 0.31,
      "networkFee": 0.0001,
      "totalFees": 0.3101
    },
    "status": "confirmed",
    "confirmations": 12,
    "estimatedProcessingTime": "2-5 minutes"
  },
  "message": "Carbon credits successfully minted and transferred"
}

Important: Token issuance requires prior verification by an accredited third party. Credits can only be issued for verified carbon sequestration activities.

Transaction Status

Check the status of token issuance and transfers

GET /v1/transactions/{transactionId}

Path Parameters

Parameter	Type	Description	Required
transactionId	string	Transaction identifier from issuance response	Yes

Example Request


GET /v1/transactions/TXN67890
Authorization: Bearer your_api_key_here

Success Response (200 OK)


{
  "status": "success",
  "data": {
    "transactionId": "TXN67890",
    "type": "credit_issuance",
    "status": "completed",
    "farmerId": "FARM12345",
    "amount": 12.35,
    "walletAddress": "abcd-efgh-ijkl-mnop-qrst-uvwx-yz12-3456",
    "blockchainDetails": {
      "txHash": "0x8f7e6d5c4b3a2918f7e6d5c4b3a2918f7e6d5c4b3a29",
      "blockNumber": 1234567,
      "confirmations": 48,
      "gasUsed": 125000
    },
    "timeline": [
      {
        "status": "initiated",
        "timestamp": "2025-07-25T11:00:00Z",
        "description": "Transaction initiated by system"
      },
      {
        "status": "validated",
        "timestamp": "2025-07-25T11:00:15Z", 
        "description": "Request validation completed"
      },
      {
        "status": "blockchain_submitted",
        "timestamp": "2025-07-25T11:00:30Z",
        "description": "Transaction submitted to blockchain"
      },
      {
        "status": "confirmed",
        "timestamp": "2025-07-25T11:02:45Z",
        "description": "Transaction confirmed on blockchain"
      },
      {
        "status": "completed",
        "timestamp": "2025-07-25T11:05:00Z",
        "description": "Tokens successfully transferred to recipient"
      }
    ],
    "metadata": {
      "vintageYear": 2025,
      "methodology": "VCS-VM0017",
      "serialNumbers": ["KE-VCS-17-001-2025-001-12350000"],
      "verificationBody": "SCS Global Services"
    },
    "createdAt": "2025-07-25T11:00:00Z",
    "completedAt": "2025-07-25T11:05:00Z",
    "processingTime": "5 minutes"
  }
}

Status Values

Status	Description	Is Final
initiated	Transaction request received and queued	No
validating	Verifying request parameters and permissions	No
blockchain_submitted	Transaction submitted to blockchain network	No
pending	Waiting for blockchain confirmation	No
confirmed	Transaction confirmed but processing	No
completed	Successfully completed	Yes
failed	Transaction failed - see error details	Yes

Marketplace API

Trading and pricing endpoints for carbon credit marketplace

List Credits for Sale

POST /v1/marketplace/listings

Request Parameters

Parameter	Type	Description	Required
sellerId	string	Farmer or aggregator identifier	Yes
credits	array	Array of credit batches to list	Yes
pricePerCredit	number	Price in USD per credit ($5.00 - $150.00)	Yes
description	string	Marketing description of the credits	No
cobenefits	array	Additional sustainability benefits	No
minimumPurchase	number	Minimum credits per transaction	No
listingDuration	number	Days listing remains active (1-365)	No

Credit Batch Object

Field	Type	Description	Required
serialNumbers	array	VCS registry serial numbers	Yes
quantity	number	Number of credits in batch	Yes
vintageYear	number	Year of carbon sequestration	Yes
methodology	string	Verification methodology (e.g., VCS-VM0017)	Yes
projectLocation	string	Geographic origin of credits	Yes
additionalityProof	string	Evidence of additionality compliance	Yes

Example Request


{
  "sellerId": "FARM12345",
  "credits": [
    {
      "serialNumbers": ["KE-VCS-17-001-2025-001-12350000"],
      "quantity": 25.75,
      "vintageYear": 2025,
      "methodology": "VCS-VM0017",
      "projectLocation": "Kiambu County, Kenya",
      "additionalityProof": "Baseline assessment demonstrates 40% increase in SOC"
    }
  ],
  "pricePerCredit": 28.50,
  "description": "Premium agroforestry credits from smallholder coffee farms. Verified biodiversity co-benefits and water conservation.",
  "cobenefits": [
    "Biodiversity enhancement", 
    "Water quality improvement",
    "Farmer income diversification",
    "Soil erosion prevention"
  ],
  "minimumPurchase": 1.0,
  "listingDuration": 90
}

Success Response (201 Created)


{
  "status": "success",
  "data": {
    "listingId": "LIST78901",
    "sellerId": "FARM12345",
    "totalCredits": 25.75,
    "pricePerCredit": 28.50,
    "totalValue": 733.88,
    "listingFee": 18.35,
    "netProceeds": 715.53,
    "status": "active",
    "listedAt": "2025-07-25T12:00:00Z",
    "expiresAt": "2025-10-23T12:00:00Z",
    "marketplaceUrl": "https://marketplace.carbonplatform.io/listing/LIST78901",
    "estimatedSaleTime": "7-14 days",
    "marketAnalysis": {
      "currentMarketPrice": 26.80,
      "pricePosition": "premium",
      "demandLevel": "high",
      "competitorCount": 12
    }
  },
  "message": "Credits successfully listed for sale"
}

Browse Available Credits

GET /v1/marketplace/browse

Query Parameters

Parameter	Type	Description	Default
region	string	Filter by geographic region	all
methodology	string	Filter by verification methodology	all
vintageYear	number	Filter by vintage year	all
minPrice	number	Minimum price per credit	0
maxPrice	number	Maximum price per credit	unlimited
cobenefits	string	Filter by co-benefits (comma-separated)	all
page	number	Page number for pagination	1
limit	number	Results per page (max 100)	20
sortBy	string	"price", "vintage", "quantity", "listed_date"	price
sortOrder	string	"asc" or "desc"	asc

Example Request


GET /v1/marketplace/browse?region=Kenya&methodology=VCS-VM0017&minPrice=20&maxPrice=40&cobenefits=biodiversity&page=1&limit=10&sortBy=price&sortOrder=asc

Success Response (200 OK)


{
  "status": "success",
  "data": {
    "listings": [
      {
        "listingId": "LIST78901",
        "sellerId": "FARM12345",
        "sellerProfile": {
          "name": "Jane Wanjiku Doe",
          "location": "Kiambu County, Kenya",
          "farmSize": 5.5,
          "yearsInProgram": 3,
          "totalCreditsSold": 156.25,
          "rating": 4.8,
          "certifications": ["Organic", "Fairtrade"]
        },
        "credits": {
          "quantity": 25.75,
          "vintageYear": 2025,
          "methodology": "VCS-VM0017",
          "verificationBody": "SCS Global Services",
          "projectType": "Agroforestry",
          "serialNumbers": ["KE-VCS-17-001-2025-001-12350000"]
        },
        "pricing": {
          "pricePerCredit": 28.50,
          "totalValue": 733.88,
          "minimumPurchase": 1.0,
          "bulkDiscounts": [
            { "minQuantity": 10, "discount": 5 },
            { "minQuantity": 25, "discount": 10 }
          ]
        },
        "cobenefits": [
          {
            "type": "Biodiversity enhancement",
            "description": "Increased bird species count by 45%",
            "evidence": "https://biodiversity-report.ipfs.io/QmX1..."
          },
          {
            "type": "Water conservation",
            "description": "35% reduction in irrigation water use",
            "evidence": "https://water-study.ipfs.io/QmY2..."
          }
        ],
        "impact": {
          "treesPlanted": 2400,
          "soilCarbonIncrease": "2.3%",
          "farmersSupported": 1,
          "communityBeneficiaries": 450
        },
        "listedAt": "2025-07-25T12:00:00Z",
        "expiresAt": "2025-10-23T12:00:00Z",
        "status": "active"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 5,
      "totalResults": 47,
      "resultsPerPage": 10,
      "hasNextPage": true,
      "hasPreviousPage": false
    },
    "marketSummary": {
      "averagePrice": 31.25,
      "priceRange": {
        "min": 18.50,
        "max": 65.00
      },
      "totalAvailableCredits": 12847.35,
      "totalListings": 47,
      "topRegions": [
        { "region": "Kenya", "count": 18 },
        { "region": "Uganda", "count": 15 },
        { "region": "Tanzania", "count": 14 }
      ]
    }
  }
}

Purchase Credits

POST /v1/marketplace/purchase

Request Parameters

Parameter	Type	Description	Required
listingId	string	Target listing identifier	Yes
quantity	number	Number of credits to purchase	Yes
buyerWallet	string	ICP wallet address for credit delivery	Yes
paymentMethod	string	"crypto" or "fiat"	Yes
retirementIntent	boolean	Whether credits will be immediately retired	No
retirementReason	string	Purpose for retirement (if applicable)	No
buyerInfo	object	Buyer identification and contact details	Yes

Buyer Info Object

Field	Type	Description	Required
name	string	Individual or organization name	Yes
email	string	Contact email address	Yes
organization	string	Company or institution name	No
country	string	Country of residence/operations	Yes
intendedUse	string	Purpose for credit purchase	No

Example Request


{
  "listingId": "LIST78901",
  "quantity": 10.5,
  "buyerWallet": "wxyz-1234-5678-9012-abcd-efgh-ijkl-mnop",
  "paymentMethod": "crypto",
  "retirementIntent": true,
  "retirementReason": "Corporate carbon neutrality - Q3 2025 emissions offset",
  "buyerInfo": {
    "name": "GreenTech Solutions Ltd",
    "email": "sustainability@greentech.co.ke",
    "organization": "GreenTech Solutions Ltd",
    "country": "Kenya",
    "intendedUse": "Corporate carbon offsetting"
  }
}

Success Response (201 Created)


{
  "status": "success",
  "data": {
    "purchaseId": "PUR34567",
    "listingId": "LIST78901",
    "quantity": 10.5,
    "pricePerCredit": 28.50,
    "subtotal": 299.25,
    "fees": {
      "platformFee": 7.48,
      "networkFee": 0.15,
      "totalFees": 7.63
    },
    "totalAmount": 306.88,
    "paymentInstructions": {
      "method": "crypto",
      "walletAddress": "carbon-escrow-wallet-123456",
      "amount": 306.88,
      "currency": "ICP",
      "timeLimit": "15 minutes"
    },
    "escrowDetails": {
      "escrowId": "ESC89012",
      "holdPeriod": "72 hours",
      "releaseConditions": "Payment confirmation and credit transfer"
    },
    "expectedDelivery": "2-4 hours after payment confirmation",
    "transactionTimeline": [
      {
        "step": "Payment",
        "status": "pending",
        "description": "Awaiting payment to escrow wallet"
      },
      {
        "step": "Verification",
        "status": "pending", 
        "description": "Payment verification and fraud checks"
      },
      {
        "step": "Transfer",
        "status": "pending",
        "description": "Credit transfer to buyer wallet"
      },
      {
        "step": "Settlement",
        "status": "pending",
        "description": "Payment release to seller"
      }
    ],
    "supportContact": {
      "email": "support@carbonplatform.io",
      "phone": "+254-700-123456",
      "hours": "24/7"
    }
  }
}

Market Analytics

GET /v1/marketplace/analytics

Query Parameters

Parameter	Type	Description	Default
timeframe	string	"7d", "30d", "90d", "1y", "all"	30d
region	string	Specific region analysis	all
methodology	string	Methodology-specific metrics	all
metric	string	"prices", "volume", "demand", "supply"	all

Success Response (200 OK)


{
  "status": "success",
  "data": {
    "timeframe": "30d",
    "generatedAt": "2025-07-25T13:00:00Z",
    "marketOverview": {
      "totalTransactionValue": 2847293.50,
      "totalCreditsTraded": 98547.25,
      "averagePrice": 28.89,
      "priceChange30d": 12.5,
      "volumeChange30d": 8.3,
      "activeListings": 347,
      "completedTransactions": 1205
    },
    "priceAnalytics": {
      "currentAveragePrice": 28.89,
      "priceRange": {
        "min": 15.20,
        "max": 85.00,
        "median": 26.50
      },
      "priceHistory": [
        { "date": "2025-06-25", "price": 25.73 },
        { "date": "2025-07-01", "price": 26.12 },
        { "date": "2025-07-08", "price": 27.45 },
        { "date": "2025-07-15", "price": 28.21 },
        { "date": "2025-07-22", "price": 28.89 }
      ],
      "methodologyPricing": [
        { "methodology": "VCS-VM0017", "averagePrice": 32.45, "volume": 25648.30 },
        { "methodology": "VCS-VM0024", "averagePrice": 28.12, "volume": 18923.75 },
        { "methodology": "Gold Standard", "averagePrice": 41.75, "volume": 12547.80 }
      ]
    },
    "regionalAnalytics": [
      {
        "region": "Kenya",
        "totalCredits": 45234.50,
        "averagePrice": 29.75,
        "priceChange": 11.2,
        "topPractices": ["Agroforestry", "No-till", "Cover cropping"],
        "farmersActive": 1247
      },
      {
        "region": "Uganda", 
        "totalCredits": 32156.25,
        "averagePrice": 27.85,
        "priceChange": 15.8,
        "topPractices": ["Agroforestry", "Improved fallow", "Composting"],
        "farmersActive": 856
      }
    ],
    "demandIndicators": {
      "buyerTypes": [
        { "type": "Corporations", "percentage": 45.2, "growth": 18.3 },
        { "type": "Governments", "percentage": 28.7, "growth": 12.1 },
        { "type": "Individuals", "percentage": 16.5, "growth": 31.4 },
        { "type": "NGOs", "percentage": 9.6, "growth": 8.7 }
      ],
      "sectorDemand": [
        { "sector": "Technology", "percentage": 32.1 },
        { "sector": "Manufacturing", "percentage": 24.8 },
        { "sector": "Aviation", "percentage": 18.5 },
        { "sector": "Energy", "percentage": 14.2 },
        { "sector": "Other", "percentage": 10.4 }
      ]
    },
    "qualityMetrics": {
      "averageRating": 4.6,
      "verificationSuccess": 98.7,
      "customerSatisfaction": 4.8,
      "repeatPurchaseRate": 67.3
    },
    "marketPredictions": {
      "nextMonthPriceEstimate": {
        "low": 29.50,
        "high": 32.75,
        "confidence": 0.78
      },
      "supplyProjection": {
        "expectedNewCredits": 15000,
        "seasonalFactors": "Post-harvest verification cycle",
        "growthRate": "22% annually"
      }
    }
  }
}

Marketplace Features: Our integrated marketplace provides real-time price discovery, automated escrow services, and comprehensive buyer protection. All transactions are recorded on the ICP blockchain for full transparency and immutability.

Farmer Success Stories

Real-world examples of carbon credit success in East Africa

John Kimani - Kiambu County, Kenya

Farm Size: 3.2 hectares
Practices: Agroforestry, No-till, Cover cropping
Annual Credits: 18.5 tons CO₂e
Revenue Increase: 42% ($1,247 additional income)
Quote: "The carbon program transformed my farm. Not only am I earning more, but my soil is healthier and my crops are more resilient to droughts."

Nakuru Farmers Cooperative - 250 Members

Total Area: 847 hectares
Practices: Rotational grazing, Silvopasture
Annual Credits: 2,156 tons CO₂e
Collective Revenue: $64,680 annually
Impact: Funded new storage facilities, solar irrigation systems, and member training programs.

Sarah Nalwoga - Bugiri District, Uganda

Farm Size: 1.8 hectares
Practices: Improved fallow, Composting
Annual Credits: 12.3 tons CO₂e
Revenue Increase: 35% ($689 additional income)
Achievement: First female farmer in her district to reach 20+ tons total credits sold.

Impact Metrics Across All Farmers

89% Increased Crop Yields

76% Reduced Input Costs

94% Improved Soil Health

67% Better Drought Resilience

Long-term Benefits: Farmers participating for 3+ years report average income increases of 58%, with 23% higher crop yields and 41% reduction in fertilizer costs due to improved soil health.

Interactive Carbon Calculator

Estimate your potential carbon credits and earnings

Use our interactive calculator to estimate potential carbon sequestration and earnings from your farm:

Region

Current Practices

No-till Agroforestry Cover Crops Composting

Implementation Level

Frequently Asked Questions

Common questions from farmers about carbon credits

What are carbon credits and how do they work?

How much money can I earn from carbon credits?

What practices qualify for carbon credits?

How long does it take to get paid?

Do I need to change all my farming practices?

What if I'm not tech-savvy? Can I still participate?

Step-by-Step Tutorials

Practical guides for implementing carbon credit practices

Setting Up No-Till Farming

Complete 6-week program covering equipment, soil preparation, seeding techniques, and weed management. Includes video demonstrations and troubleshooting guide.

Duration: 6 weeks
Difficulty: Beginner
Equipment needed: Basic hand tools

Agroforestry System Design

Learn to design and establish tree-crop systems for maximum carbon sequestration and productivity. Covers species selection, spacing, and management.

Duration: 8 weeks
Difficulty: Intermediate
Equipment needed: Measuring tools, nursery setup

Cover Crop Management

Master cover crop selection, establishment, and termination for different farming systems. Includes season planning and integration with cash crops.

Duration: 4 weeks
Difficulty: Beginner
Equipment needed: Seeds, basic tools

Composting for Carbon

Build high-quality compost systems that maximize carbon retention and soil health benefits. Covers materials, ratios, monitoring, and application.

Duration: 3 weeks
Difficulty: Beginner
Equipment needed: Organic materials, thermometer

Using the Mobile App

Complete guide to our farmer mobile app for reporting practices, uploading photos, tracking progress, and managing your carbon credit account.

Duration: 2 weeks
Difficulty: Beginner
Equipment needed: Smartphone or basic phone

Soil Health Monitoring

Learn simple techniques for monitoring soil organic matter, compaction, and biological activity to optimize carbon sequestration practices.

Duration: 3 weeks
Difficulty: Intermediate
Equipment needed: Soil auger, pH strips, jar

Learning Pathways

🌱 Beginner Pathway (3-4 months)

Perfect for farmers new to climate-smart agriculture:

Using the Mobile App (Week 1-2)
Cover Crop Management (Week 3-6)
Composting for Carbon (Week 7-9)
Setting Up No-Till Farming (Week 10-15)

🚀 Advanced Pathway (6-8 months)

For experienced farmers ready to maximize carbon potential:

Soil Health Monitoring (Month 1)
Agroforestry System Design (Month 2-3)
Advanced Integration Techniques (Month 4-5)
Business Planning & Marketing (Month 6)

Interactive Learning: All tutorials include interactive quizzes, progress tracking, and direct connection to field officers for personalized support. Complete the pathway to earn certification and access to premium markets.

Contact Support

Get help from our team of agricultural and technical experts

24/7 Farmer Hotline

Phone: +254-700-CARBON (+254-700-227266)
WhatsApp: +254-700-227266
SMS: Text "HELP" to 29429
Languages: English, Swahili, Kikuyu, Luo, French
Response Time: Immediate for urgent issues

Email Support

General Support: farmers@carbonplatform.io
Technical Issues: tech@carbonplatform.io
Payment Questions: payments@carbonplatform.io
Verification: verify@carbonplatform.io
Response Time: 4-6 hours during business days

Field Officers

Coverage: All participating regions
Services: On-farm visits, training, problem-solving
Scheduling: Call hotline or use mobile app
Languages: Local languages + English/Swahili
Response Time: 1-3 days for visit scheduling

Video Consultations

Platform: WhatsApp Video, Zoom, or phone call
Specialists: Agronomists, carbon experts, tech support
Booking: Through mobile app or hotline
Duration: 15-45 minutes
Cost: Free for registered farmers

Regional Support Centers

🇰🇪 Kenya Hub - Nairobi

Address: Carbon House, Westlands, Nairobi
Phone: +254-20-1234567
Counties Served: Nairobi, Kiambu, Nakuru, Meru, Embu
Staff: 15 field officers, 3 technical specialists

🇺🇬 Uganda Hub - Kampala

Address: Plot 123, Industrial Area, Kampala
Phone: +256-41-234567
Districts Served: Central, Eastern, Western regions
Staff: 12 field officers, 2 technical specialists

🇹🇿 Tanzania Hub - Arusha

margin-bottom: 8px; color: var(--dark);">Farm Size (hectares)

Error Codes

Below are common error codes returned by the Carbon Credit Platform API, their meanings, and suggested actions.

400

Bad Request

Check your request parameters for missing or invalid values.

401

Unauthorized

Ensure your API key or token is valid and included in the request.

403

Forbidden

Your credentials do not have permission to access this resource.

404

Not Found

The requested resource does not exist. Check the endpoint URL.

409

Conflict

There is a conflict with the current state of the resource. Review your request logic.

429

Too Many Requests

You have exceeded the rate limit. Wait and try again later.

500

Internal Server Error

Server encountered an error. Try again or contact support if the issue persists.

Greencoin Carbon Credit Platform API Documentation

🔬 Soil Sampling Protocol

🌳 Biomass Measurement

📋 Activity Documentation

🛰️ Remote Sensing Integration

Your Carbon Credit Potential

What are carbon credits and how do they work?

How much money can I earn from carbon credits?

What practices qualify for carbon credits?

How long does it take to get paid?

How long does it take to get paid?

Do I need to change all my farming practices?

What if I'm not tech-savvy? Can I still participate?

🌱 Beginner Pathway (3-4 months)

🚀 Advanced Pathway (6-8 months)

🇰🇪 Kenya Hub - Nairobi

🇺🇬 Uganda Hub - Kampala

🇹🇿 Tanzania Hub - Arusha

Error Codes