API Versioning

Version history and migration guides

Current Versions

API	Version	Status	Base Path
Carbon	v1	Current	`/api/v1/carbon/`
Disclosure	v3	Current	`/api/v3/disclosure/`
Attestation	v2	Current	`/api/v2/attestation/`
RWA Feeds	v1	Current	`/api/v1/feeds/`
NFT	v1	Current	`/api/nft/`

Versioning Policy

Major versions (v1 → v2): Breaking changes, 12-month migration
Minor updates: Backward compatible, no migration needed
Deprecation: 6-month notice before sunset

Stability guarantee: Current versions will be supported for minimum 24 months.

Disclosure API History

v3 Current

Released: January 2026

Added MiCA Article 66 support
Standardized response schema
Added meta.request_id

v2 Deprecated

Sunset: July 2026

Legacy response format
No MiCA support

Attestation API History

v2 Current

Released: December 2025

Multi-chain anchoring (Polygon, Base, Arbitrum, ETH)
Cryptographic receipts
DAP protocol support

v1 Sunset

Sunset: December 2025

Single-chain only
No longer available

Migration Guide: Disclosure v2 → v3

Endpoint Changes

v2 (Old)	v3 (New)
`/api/v2/disclosure/info`	`/api/v3/disclosure/networks`
`/api/v2/disclosure/chain/{id}`	`/api/v3/disclosure/sustainability/{symbol}`

Response Changes

# v2 Response (Old)
{
  "status": "ok",
  "data": {...}
}

# v3 Response (New)
{
  "data": {...},
  "meta": {
    "feed_name": "disclosure",
    "schema_version": "1.0.0",
    "request_id": "req_abc123"
  }
}

Version Header

All responses include version info:

X-API-Version: v3
X-Schema-Version: 1.0.0

Deprecation Notices

Deprecated endpoints return warning headers:

X-Deprecated: true
X-Sunset-Date: 2026-07-01
X-Upgrade-To: /api/v3/disclosure/

Subscribe to updates: Join our mailing list for deprecation notices at /subscribe

← Back to Documentation · Changelog