Get price forecast (GET)

get

https://api.freightos.com/fd_external_apis/price_forecast/

Retrieve a weekly price forecast using query parameters. You can forecast a single route by providing all route parameters, or forecast your subscription routes by omitting route parameters.

Rate Limit: 30 requests per minute
Typical Response Time: 5-30 seconds

Forecast Horizon: The number of forecasted weeks is capped by your subscription's horizon (default 3 months ≈ 13 weekly rows). Requesting more weeks than allowed returns the maximum your subscription permits.

Route Quota: Forecast requests use the same unique-route quota as the Price Stats API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

origin

string

Origin location for the shipment (e.g., 'CNSHA'). Required for single route queries along with destination, mode, and load.

destination

string

Destination location for the shipment (e.g., 'USLAX'). Required for single route queries along with origin, mode, and load.

mode

string

Transportation mode. Accepts 'FCL', 'Air', or 'ocean' (alias for FCL). Required for single route queries along with origin, destination, and load. When provided, tradelanes_type is inferred automatically.

load

string

Load tag identifier (e.g., 20', 40', 40'HC, 20DC, 40DC, 40HC). Required for single route queries along with origin, destination, and mode. The API automatically maps: 20DC → 20', 40DC → 40', 40HC → 40'HC

horizon_weeks

integer

1 to 104

Defaults to 52

Number of weeks to forecast into the future (1-104). Automatically capped at your subscription's forecast horizon.

rate_type

string

enum

Defaults to SPOT

Type of rate to forecast. Requires special permissions for CONTRACT and ALL types

Allowed:

tradelanes_type

string

enum

Type of tradelane. Required only when not specifying a single route and mode is omitted; inferred from mode otherwise

Allowed:

route_type

string

enum

Type of route to filter by. Valid values: 'P2P' (Port to Port), 'C2C' (Country to Country), 'R2R' (Region to Region)

Allowed:

version

string

enum

Defaults to weekly

Data version used as forecast input. Defaults to your subscription's default version

Allowed:

Responses

200Successful response

400Bad request - validation error, quota exceeded, or missing permissions. Common errors include: forecast API not included in subscription, missing required parameters, route quota exceeded, or missing permissions for contract rates.

500Internal server error