Home → Blog

Introduction

In the fast-paced world of logistics, freight claims can be a significant pain point for operators, leading to financial losses and operational inefficiencies. The complexity of managing multiple data sources for fuel prices, freight rates, port congestion, and carrier information can overwhelm logistics teams. Without a consolidated view of these critical metrics, operators often find themselves reacting to issues rather than proactively managing them. This is where FreightPulse comes into play, offering a comprehensive REST API that consolidates real-time logistics intelligence into a single, easy-to-use interface.

By leveraging FreightPulse, logistics operators can reduce freight claims through proactive strategies that enhance visibility and decision-making. This blog post will explore how FreightPulse can streamline operations, improve data accuracy, and ultimately lead to better outcomes for logistics teams. We will delve into the API's features, provide practical examples, and demonstrate how to get started with FreightPulse.

Why FreightPulse

FreightPulse stands out in the logistics landscape for several reasons that directly benefit developers and operators:

Quick Start

To get started with FreightPulse, you can access the API at the following base URL:

https://freightpulsehq.com/api/v1

Authentication is handled via the X-API-Key header, which is required for most requests. However, unauthenticated requests are allowed up to 100 per day per IP, making it easy to explore the API without any setup.

Here’s an example of how to make your first request to retrieve national diesel and gasoline prices:

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/fuel-prices"

The expected JSON response will look like this:

{
"success": true,
"data": {
"timestamp": "2026-07-30T12:00:00Z",
"source": "EIA (U.S. Energy Information Administration)",
"currency": "USD",
"unit": "gallon",
"data": {
"diesel": {
"national_average": 3.847,
"change_week": -0.023,
"change_percent": -0.6,
"regions": {
"east_coast": 3.912,
"midwest": 3.756,
"gulf_coast": 3.623,
"rocky_mountain": 3.891,
"west_coast": 4.456,
"california": 4.892
},
"historical": {
"30d_avg": 3.82,
"90d_avg": 3.75,
"yoy_change_percent": -8.2
}
},
"gasoline": {
"national_average": 3.156,
"historical": {
"30d_avg": 3.1,
"90d_avg": 3.05,
"yoy_change_percent": 1.1
}
}
}
}
}

In this response, key fields include:

Core Endpoints

FreightPulse offers several core endpoints that are essential for logistics operations. Below, we will cover three key endpoints relevant to reducing freight claims.

1. GET /fuel-prices

This endpoint provides national diesel and gasoline prices, including a breakdown by PADD region and historical averages.

Key Parameters: None required.

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/fuel-prices"

Example JSON Response:

{
"success": true,
"data": {
"timestamp": "2026-07-30T12:00:00Z",
"source": "EIA (U.S. Energy Information Administration)",
"currency": "USD",
"unit": "gallon",
"data": {
"diesel": {
"national_average": 3.847,
"change_week": -0.023,
"change_percent": -0.6,
"regions": {
"east_coast": 3.912,
"midwest": 3.756,
"gulf_coast": 3.623,
"rocky_mountain": 3.891,
"west_coast": 4.456,
"california": 4.892
},
"historical": {
"30d_avg": 3.82,
"90d_avg": 3.75,
"yoy_change_percent": -8.2
}
},
"gasoline": {
"national_average": 3.156,
"historical": {
"30d_avg": 3.1,
"90d_avg": 3.05,
"yoy_change_percent": 1.1
}
}
}
}
}

Field Explanations:

2. GET /freight-rates

This endpoint provides live FTL truckload quotes for U.S. lanes, which is essential for pricing and capacity planning.

Key Parameters: mode (trucking, ocean, air), origin_zip, destination_zip (required for trucking).

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/freight-rates?mode=trucking&origin_zip=10001&destination_zip=90210"

Example JSON Response:

{
"success": true,
"data": {
"mode": "trucking",
"service": "FTL (53' dry van)",
"source": "Warp",
"price_usd": 7207.92,
"transit_days": 4,
"pickup_date": "2026-08-24",
"delivery_date": "2026-08-28"
}
}

Field Explanations:

3. GET /port-congestion

This endpoint provides insights into port activity, which is vital for understanding potential delays in the supply chain.

Key Parameters: port (name or LOCODE), country (name or ISO3), region (continent).

curl -H "X-API-Key: YOUR_API_KEY" "https://freightpulsehq.com/api/v1/port-congestion?port=USLAX"

Example JSON Response:

{
"success": true,
"data": {
"results": [
{
"port": "Los Angeles-Long Beach",
"locode": "US LAX",
"country": "United States",
"congestion": "moderate",
"as_of": "2026-08-14",
"metrics": {
"recent_avg_portcalls_per_day": 8.7,
"baseline_avg_portcalls_per_day": 10.2,
"ratio_vs_baseline": 0.85
}
}
]
}
}

Field Explanations:

Real-World Use Cases

FreightPulse's API can be utilized in various ways to enhance logistics operations and reduce freight claims. Here are three concrete examples:

FAQ

How often do FreightPulse fuel prices update?

FreightPulse fuel prices are updated weekly, providing operators with timely information to make informed decisions regarding fuel surcharges and budgeting.

Can I look up ocean carriers as well as trucking carriers?

Yes, the /carriers endpoint allows you to look up both ocean NVOCC/OTI carriers and trucking carriers, providing a comprehensive view of available transportation options.

Does the port congestion data reflect real-time vessel wait times?

No, the port congestion data from FreightPulse is based on a 7-day average and is not real-time. It provides a lagged approximation of port activity, which is essential for understanding trends but should not be relied upon for immediate vessel wait times.

Conclusion

In conclusion, FreightPulse offers a powerful solution for logistics operators looking to reduce freight claims and enhance operational efficiency. By consolidating critical logistics data into a single API, FreightPulse empowers teams to make proactive decisions based on real-time insights. From fuel prices to port congestion and carrier verification, the FreightPulse API provides the tools necessary to navigate the complexities of modern supply chains.

To explore the capabilities of FreightPulse and see how it can transform your logistics operations, try FreightPulse for free today. With easy access to vital data, you can streamline your processes, reduce claims, and ultimately improve your bottom line.