API Documentation

FreightPulse API provides real-time logistics intelligence — port congestion, freight rates, fuel prices, disruptions, and carrier data. Integrate global supply chain visibility into your applications in minutes.

Base URL

All API requests use the following base URL:

                https://freightpulsehq.com/api/v1
            

Authentication

Authenticate your requests by including your API key in the X-API-Key header. Free tier includes 100 calls/month — no credit card required.

                curl -H "X-API-Key: YOUR_API_KEY" \

                  https://freightpulsehq.com/api/v1/port-congestion

Don't have an API key yet? Sign up free →

Rate Limits & Pricing

Plan	Price	Monthly Limit
Free	$0	100/month
Basic	$49/mo	1,000/month
Pro	$99/mo	10,000/month
Business	$299/mo	25,000/month
Enterprise	$499/mo	100,000/month

All paid plans include a 7-day free trial. Cancel anytime.

GET /api/v1/port-congestion

Retrieve real-time port congestion data worldwide. Filter by port name, country, region, or congestion level. Includes vessel counts, wait times, and trend analysis.

Parameters

port string

country string

region string

congestion string

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/freight-rates

Get current freight rates across ocean, trucking, and air transport modes. Includes major indices (FBX, SCFI), lane-level container rates, and market trends.

Parameters

mode string

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/fuel-prices

Retrieve current fuel prices including diesel, gasoline, and bunker fuel (VLSFO/HSFO). Updated daily with regional breakdowns and weekly change indicators.

Parameters

No parameters required.

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/disruptions

Get active supply chain disruptions and alerts. Includes weather events, port closures, labor actions, and geopolitical incidents affecting global logistics.

Parameters

No parameters required.

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/carriers

Browse carriers across ocean, trucking, and air transport. Includes performance metrics, fleet size, coverage areas, and reliability scores.

Parameters

type string

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/historical PRO

Access historical logistics data for trend analysis. Requires a Pro plan or higher. Available metrics include FBX global index, congestion averages, diesel prices, and trucking rates.

Parameters

metric string

period number

Response

Click "Send Request" to see the live response

Example Response

GET /api/v1/export PRO

Export logistics data in CSV or JSON format. Requires a Pro plan or higher. Download port congestion, freight rates, or disruption data for offline analysis.

Parameters

type string

format string

Response

Click "Send Request" to see the live response

Example Response

Error Handling

The API returns standard HTTP status codes. Errors include a JSON body with details.

Code	Meaning	Description
400	Bad Request	Invalid or missing parameters. Check the request format.
401	Unauthorized	Missing or invalid API key. Ensure `X-API-Key` header is set.
403	Forbidden	Your plan doesn't include access to this endpoint. Upgrade at /pricing.
429	Rate Limited	You've exceeded your monthly API call limit. Wait or upgrade your plan.
500	Server Error	Something went wrong on our end. Try again or contact support.

{
  "success": false,
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Upgrade your plan for more calls.",
    "limit": 100,
    "used": 100,
    "reset": "2026-04-01T00:00:00Z"
  }
}
            