API Reference

Complete API documentation for all Tenzro Platform services. All endpoints require authentication and return JSON responses.

Base URL

https://api.platform.tenzro.com

Authentication

All requests require these headers:

Authorization: Bearer <api_key>
X-Tenant-ID: <tenant_id>
Content-Type: application/json

Response Format

Successful responses return a JSON object:

{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Error Format

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request parameters",
    "details": [
      { "field": "amount", "message": "Must be positive" }
    ]
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z"
  }
}

Services

ServiceBase PathDescription
Auth/api/authAuthentication and session management
Wallet/api/walletMulti-chain wallet management
Token/api/tokenToken operations and transfers
Bridge/api/bridgeCross-chain asset transfers
Custody/api/custodyMPC key management and signing
Ledger/api/ledgerDouble-entry accounting
AI/api/aiTEE-secured AI inference
Anchor/api/anchorBlockchain data anchoring
API Keys/api/apikeysAPI key management
Provision/api/provisionTenant provisioning
Events/api/eventsReal-time event streaming

Pagination

List endpoints support cursor-based pagination:

GET /api/wallet/list?limit=20&cursor=eyJpZCI6MTIzfQ

Response:
{
  "data": [...],
  "meta": {
    "cursor": "eyJpZCI6MTQzfQ",
    "hasMore": true
  }
}

Rate Limiting

Rate limit information is included in response headers:

HeaderDescription
X-RateLimit-LimitMaximum requests per window
X-RateLimit-RemainingRequests remaining
X-RateLimit-ResetUnix timestamp when window resets

Idempotency

For mutation operations, include an X-Idempotency-Key header to prevent duplicate operations:

POST /api/token/transfer
X-Idempotency-Key: unique-request-id-123

{
  "from": "wallet_abc",
  "to": "0x...",
  "amount": "1000000000"
}