Get market rates

get

https://api.xeneta.com/v3.0/air/market-rates

Returns air freight market rates within the specified parameters.

Query Params

origin

string

required

Defaults to PVG

Defines the origin location of the requested market rate data. Can be either an IATA airport code or a region as defined in Xeneta's geo-hierarchy. For example, PVG or east_china_main.

destination

string

required

Defaults to FRA

Defines the destination location of the requested market rate data. Can be either an IATA airport code or a region as defined in Xeneta's geo-hierarchy. For example, FRA or north_europe_main.

date_from

date

required

Defaults to 2023-02-01

Defines the start date of the date range for the requested market rates in the YYYY-MM-DD format. The total range cannot exceed 31 days.

date_to

date

required

Defaults to 2023-02-05

Defines the end date of the date range for the requested market rates in the YYYY-MM-DD format. The total range cannot exceed 31 days.

contract_length

string

required

Defaults to long

Defines the type of contract for the requested market rate data. long is the only accepted value.

contracted_within

string

required

Defaults to all

Defines the maximum age of the contracts to be included in the requested market rate data, relative to each day. Accepted values include all and 3months.

weight_bracket

string

required

Defaults to greater_than_500kg

Defines the weight category of the requested rate data. Accepted values are less_than_45kg, greater_than_45kg, greater_than_200kg, greater_than_500kg, and greater_than_1000kg.

service_level

string

required

Defaults to mid_tier

Defines the service level of the requested rate data. Accepted values are upper_tier, mid_tier, lower_tier, lower_and_mid_tier, and passive.

bump_up

boolean

Defaults to true

Defines whether to allow rates from larger geographic regions in the response if there is not enough data for the requested origin and destination. Using false when there is no rate data available for the requested origin and destination will return an error.

Response

200200