EcoTrack API Documentation - Mirasi Provisions

Overview

The EcoTrack API provides programmatic access to our blockchain-verified environmental traceability platform. Built for brands, recyclers, and partners who need to integrate recycling data, compliance reporting, and material tracking into their systems.

Performance

500+

Requests per second with sub-100ms response times

Reliability

99.9%

Uptime with automatic failover and monitoring

Blockchain

IOTA

Feeless distributed ledger for immutable records

Security

HTTPS

TLS 1.3 encryption with token-based authentication

Base URL: https://api.mirasiprovisions.com/v2
Response Format: JSON
Character Encoding: UTF-8

Authentication

All API requests require authentication using Bearer tokens. Tokens are obtained through our OAuth 2.0 flow or provided during partner onboarding.

// Include token in Authorization header
Authorization: Bearer <your_access_token>
                    

Security Best Practices

Never expose tokens in client-side code or public repositories
Use HTTPS only - all requests must be encrypted
Rotate tokens regularly - implement token refresh mechanisms
Scope access appropriately - request only permissions needed

Note: Detailed authentication flow and token management documentation is available to verified partners under NDA.

Collections

Manage plastic waste collection records with GPS verification and blockchain notarization.

GET /collections

Retrieve verified plastic collection records with filtering options.

Query Parameters

Parameter	Type	Required	Description
status	string	Optional	Filter by collection status (verified, pending, transferred)
date_from	string	Optional	Start date (ISO 8601 format)
date_to	string	Optional	End date (ISO 8601 format)
limit	integer	Optional	Number of records to return (default: 50, max: 200)

Response (200 OK)

{
  "data": [
    {
      "id": "coll_abc123",
      "weight_kg": 15.5,
      "material_type": "PET",
      "status": "verified",
      "collected_at": "2026-05-07T10:30:00Z",
      "blockchain_verified": true
    }
  ],
  "pagination": {
    "total": 1250,
    "page": 1,
    "per_page": 50
  }
}
                                

Material Passports

Digital identities for recycled materials with complete traceability from collection to recycling.

GET /passports/{passport_id}

Retrieve complete material passport with journey history and blockchain verification.

Path Parameters

Parameter	Type	Required	Description
passport_id	string	Required	Unique passport identifier (UUID)

Response (200 OK)

{
  "passport_id": "pass_xyz789",
  "qr_code": "https://app.mirasiprovisions.com/verify/xyz789",
  "material_type": "HDPE",
  "total_weight_kg": 125.0,
  "journey": [
    {
      "stage": "collection",
      "timestamp": "2026-05-01T08:00:00Z",
      "location": "Nairobi, Kenya"
    },
    {
      "stage": "aggregation",
      "timestamp": "2026-05-03T14:30:00Z"
    }
  ],
  "blockchain": {
    "transaction_hash": "0xabc...123",
    "verified": true
  }
}
                                

Transfers

Secure ownership transfers between stakeholders with GPS verification and automatic blockchain updates.

POST /transfers

Initiate a material transfer between verified parties.

Request Body

{
  "from_user_id": "user_123",
  "to_user_id": "user_456",
  "collection_ids": ["coll_abc", "coll_def"],
  "gps_coordinates": {
    "latitude": -1.286389,
    "longitude": 36.817223
  }
}
                            

Response (201 Created)

{
  "transfer_id": "trans_789",
  "status": "pending",
  "created_at": "2026-05-07T15:00:00Z",
  "requires_confirmation": true
}
                                

Marketplace

Trade verified recycled materials with transparent pricing and quality assurance.

GET /marketplace/listings

Browse available recycled material listings with verification status.

Query Parameters

Parameter	Type	Required	Description
material_type	string	Optional	Filter by material (PET, HDPE, PP, etc.)
min_weight_kg	number	Optional	Minimum weight in kilograms
verified_only	boolean	Optional	Show only blockchain-verified listings

Analytics

Access environmental impact metrics and compliance reporting data.

GET /analytics/impact

Retrieve aggregated environmental impact metrics for reporting.

Response (200 OK)

{
  "period": "2026-Q1",
  "total_kg_recycled": 45230,
  "co2_offset_kg": 67845,
  "collections_count": 3421,
  "active_collectors": 892,
  "blockchain_transactions": 3421
}
                                

Webhooks

Receive real-time notifications for important events in the EcoTrack ecosystem.

Available Events

collection.verified - When a collection is blockchain-verified
transfer.completed - When ownership transfer is confirmed
passport.created - When a new material passport is generated
marketplace.listing.created - When new material is listed for sale

Note: Webhook configuration and payload schemas are available to verified partners during integration onboarding.

Rate Limits

API requests are rate-limited to ensure fair usage and system stability.

Standard Tier

100

Requests per minute

Partner Tier

500

Requests per minute

Enterprise Tier

2000

Requests per minute (custom limits available)

Rate Limit Headers: All responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.

Support & Integration

Need help integrating with the EcoTrack API? We're here to assist.

Documentation: This guide provides public API overview
Technical Support: Available for verified partners
Sandbox Environment: Test integration before going live
SDK Libraries: Coming soon for major programming languages

Become an Integration Partner

Get full API access, technical documentation, sandbox environment, and dedicated support.

Request API Access