GULF REROUTE DOCS

PLATFORM DOCUMENTATION

Comprehensive guide to the Gulf Freight Reroute & Risk Intelligence API.

01. OVERVIEW

Gulf Reroute is a strictly automated parsing engine focused on marine and aviation logistics in the Gulf Region (Strait of Hormuz, Red Sea, Bab el-Mandeb).

Every 15 minutes, our ingestion engine scrapes raw telemetry from AviationStack and MarineTraffic, feeds it through an LLM trained on our proprietary risk schema, and outputs deterministic JSON highlighting delays, blockages, reroutes, and cost impacts.

02. RISK CATEGORIES

Our AI assigns a risk score between 0-100 to every monitored route based on real-time disruption severity, congestion at destination ports, and surrounding geopolitical events.

LOW (0-24)

Normal operations. No current active threats or significant delays reported on this route. Standard transit times apply.

MODERATE (25-49)

Minor delays or congestion detected. Port backups or minor weather events causing slight transit time increases.

HIGH (50-74)

Significant rerouting or sustained blockage. Vessels actively avoiding normal lanes, incurring substantial delay/cost increases.

CRITICAL (75-100)

Major disruption, full stop, or active security threat. Extreme danger or complete impassability in the sector.

03. REST API REFERENCE

ENDPOINT

GEThttps://api.gulfreroute.com/v1/freight

AUTHENTICATION

Pass your active API key using the standard Bearer token header.

Authorization: Bearer gf_production_key_here

RATE LIMITS & PRICING

Rate limits are enforced automatically based on your active plan tier.

TACTICAL (48-HOUR)
10 req / day
STRATEGIC (MONTHLY)
1,000 req / day

ERROR RESPONSES & STATUS CODES

HTTP 401 Unauthorized
{
  "error": "Missing or invalid API key"
}

HTTP 429 Too Many Requests
{
  "error": "Rate limit exceeded. Try again in 3600s."
}

HTTP 502 Bad Gateway
{
  "success": false,
  "error": "All external data sources failed"
}

TYPICAL JSON RESPONSE

{
  "success": true,
  "timestamp": "2026-10-24T08:15:00Z",
  "data": {
    "summary": "Strait of Hormuz congestion critically elevating TEU costs.",
    "overallRiskLevel": "critical",
    "totalBlockedRoutes": 3,
    "totalDelayedRoutes": 7,
    "avgCostIncreasePct": 42.5,
    "routes": [
      {
        "id": "hormuz-bound",
        "name": "Jebel Ali to Rotterdam",
        "type": "marine",
        "status": "blocked",
        "reason": "Security hold",
        "delayHours": 72,
        "costImpactPct": 150,
        "riskScore": 95,
        "alternativeRoute": "Cape of Good Hope"
      }
    ],
    "keyDisruptions": [
      "Vessels actively avoiding normal lanes"
    ]
  }
}