Get price statistics (GET)

get

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

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

Rate Limit: 10 requests per minute Typical Response Time: 2-16 seconds

Route Quota: Each subscription has a limit on unique routes you can query. Routes are uniquely identified by origin, destination, mode, and load tag. Only routes that return actual data (with coverage) count toward your quota. Once a route is stored with coverage, you can query it repeatedly without using quota. If you exceed your quota, you'll receive an error message indicating how many routes you're allowed and how many you requested.

Query Params

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:

from_date

date

required

Start date for the statistics in YYYY-MM-DD format

to_date

date

required

End date for the statistics in YYYY-MM-DD format

tradelanes_type

string

enum

Type of tradelane. Required if not specifying a single route (all 4 route parameters: origin, destination, mode, load)

Allowed:

version

string

enum

Defaults to weekly

Data version. Defaults to your subscription's default version

Allowed:

origin

string

Origin location for the shipment. Accepts three formats: port code (e.g., 'CNSHA'), country code (e.g., 'CN'), or region (e.g., 'Asia, China, South-East Asia'). Required for single route queries along with destination, mode, and load.

destination

string

Destination location for the shipment. Accepts three formats: port code (e.g., 'USLAX'), country code (e.g., 'US'), or region (e.g., 'Americas, US West'). Required for single route queries along with destination, mode, and load.

mode

string

enum

Transportation mode. Required for single route queries along with origin, destination, and load

Allowed:

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

route_matching

string

enum

Defaults to similar

Route matching mode. Use 'exact' to return only exact route matches, or 'similar' to return averaged statistics across similar routes. Note: 'similar' mode is only available for port-to-port (P2P) route types; all other route types support 'exact' mode only.

Allowed:

shipment_priority

string

Defaults to ALL

Filter by shipment priority

rate_type

string

enum

Defaults to SPOT

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

Allowed:

include_change

boolean

Defaults to false

Include change metrics (volatility and change percentage) in the response

date

Single date parameter (alternative to from_date/to_date). Sets both from_date and to_date to this value

tradelane

string

enum

Alias for tradelanes_type parameter

Allowed:

Responses

200Successful response

400Bad request - validation error or quota exceeded. Common errors include: missing required parameters, invalid date format, route quota exceeded, or missing permissions for contract rates.

500Internal server error