WATRAS API

Programmable Regulatory Data Infrastructure

The WATRAS API provides programmatic access to our attestation engine for integration into your trade workflows, logistics platforms, or banking systems.

Quick Start

Attestation Request Example

// Attestation Request Example
const response = await fetch('https://api.watras.org/v1/attestations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    corridor: 'GH-TG',
    hs_code: '030614',
    origin: 'GH',
    destination: 'TG',
    value_usd: 5000,
    quantity: 100,
    description: 'Frozen shrimps'
  })
});

const attestation = await response.json();
// Returns: PDF URL, source citations, timestamp, consistency warnings

API Endpoints

Endpoint	Method	Description
/v1/attestations	POST	Create new attestation
/v1/attestations/{id}	GET	Retrieve attestation
/v1/corridors	GET	List available corridors
/v1/hs-codes	GET	Search HS codes
/v1/sources	GET	List regulatory sources
/v1/validators	GET	Validator network info

Authentication & Rate Limits

Authentication

API key required in Authorization header.

Authorization: Bearer YOUR_API_KEY

Request API key:

api@watras.org

Rate Limits by Tier

Public (free)10 req/hour

Partner1,000 req/day

Enterprise10,000 req/day

CustomContact us

Rate Limit Response:

429 Too Many Requests
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1643723400

Response Object Schema

{
  "id": "att_1234567890",
  "status": "completed",
  "corridor": "GH-TG",
  "timestamp": "2026-02-04T10:30:00Z",
  "validity": "point_in_time_only",
  
  "consistency": {
    "overall": "consistent",
    "warnings": [
      {
        "field": "hs_code",
        "message": "HS 030614 not found in ECOWAS TEC 2025",
        "source": "TEC_CEDEAO_2025",
        "severity": "medium"
      }
    ]
  },
  
  "sources": [
    {
      "title": "Updated ECOWAS TEC 2025",
      "authority": "ECOWAS",
      "date": "2025-01-15",
      "url": "https://ecowas.int/tec-2025.pdf",
      "sections_cited": ["Chapter 03, Seafood Products"]
    }
  ],
  
  "pdf_url": "https://cdn.watras.org/attestations/att_1234567890.pdf",
  
  "disclaimer": "This attestation is a non-binding analytical reference."
}

Integration Use Cases

E-Commerce Platforms

→ Compliance check at checkout
→ Automatic duty/tax estimation
→ Documentation generation for clearance

ERP Systems

SAP, NetSuite, Odoo

→ WATRAS plugin for pre-submission check
→ Attestation generation for invoices
→ Audit trail for exports

Banks (Trade Finance)

→ Pre-LC validation before issuance
→ Document consistency verification
→ Risk assessment tool

Logistics Providers

DHL, Maersk, BOLLORE

→ Shipping quote calculator
→ Pre-shipment checks
→ Automated client portal

Ready to Integrate WATRAS?

Get started with our API documentation and developer resources

api@watras.org