Home

Get Rates

Unlock the power of global shipping rates with our API and revolutionize your customer experience. Seamlessly access shipping rates from carriers in over 190 countries and elevate your service to new heights. With our API, you can develop innovative solutions tailored to your clients' needs, delivering accurate and competitive shipping rates at their fingertips.

API endpoint

1https://rates.searates.com/graphql

Query params

PropertyTypeDescription
shippingTypeenum

Main shipping type for search. Must be one of the following possible values: FCL, LCL, BULK, FTL, LTL, LAND_FCL, RAIL_FCL, AIR. In working: FWL, LWL, RAIL_FTL.

coordinatesFrom[Float]

The coordinatesFrom field specifies the place of departure. It consists of an array containing two float values: [latitude longitude].

coordinatesTo[Float]

The coordinatesTo field specifies the destination. It consists of an array containing two float values: [latitude longitude].

pointIdFromString

Place of departure consisting of a type identifier and an ID separated by an underscore. Possible types: P (Port), A (Airport), C (City).
Example: "P_304".

pointIdToString

Destination consisting of a type identifier and an ID separated by an underscore. Same as pointIdFrom.

dateDate

Ready to load date in the format YYYY-MM-DD.

containerenum

Searched container type used in the following shipping types: FCL, LAND_FCL, RAIL_FCL. Must be one of the following possible values: ST20, ST40, HC20, HC40, HC45, REF20, REF40.

weightFloat

Searched weight used in the following shipping types: LCL, BULK, FTL, LTL, AIR.

weightUnitenum

Preferred unit measurement for the weight. Must be one of the following possible values: KG, LBS, MT.

volumeFloat

Searched volume used in the following shipping types: LCL, FTL, LTL, AIR.

volumeUnitenum

Preferred unit measurement for the volume. Must be one of the following possible values: M3, FT3.

expiredBoolean

Include expired rates from the last 3 months if true.

includedServicesenum

Indicates whether to include transportation from location to departure port and from destination port to location.
Must be one of the following possible values: p2p, d2d, d2p, p2d.

portFromFeesBoolean

Indicates whether to include departure port fees in the results.

portToFeesBoolean

Indicates whether to include destination port fees in the results.

Response

PropertyTypeDescription
points[point]

The points field contains information about the route consisting of individual points. Each point contains details about a specific part of the route.

locationobject

Contains information about the location of the current point.
Fields: name (String), country (String), lat (Float), lng (Float), code (String), inaccessible (Boolean), pointType (enum: PORT, PLACE, AIRPORT).

shippingTypeenum

Can be one of the following: FCL, LCL, BULK, FTL, LTL, LAND_FCL, RAIL_FCL, AIR.

providerString

Specifies the name of the carrier.

loads[Load]

Detailed information about the requested container weight or volume.
Fields: unit (String), amount (String), type (String).

pointTariff[Tariff]

Array of tariffs specific to the current point.
Fields: name (String), abbr (String), price (Float), currency (String).

routeTariff[Tariff]

Array of tariffs specific to the transportation from the current point to the next point.
Fields: name (String), abbr (String), price (Float), currency (String).

lumpsumTariffTariff

The lumpsumTariff field includes the total price for multiple points.
Fields: name (String), abbr (String), price (Float), currency (String).

co2object

The co2 field includes information about CO2 emissions for this point and for the route from this point to the next point.
Fields: amount (Float), price (Float), placeAmount (Float), placePrice (Float).

distanceFloat

Distance from this point to the next point.

pointTotalFloat

Total price of all pointTariff.

routeTotalFloat

Total price of all routeTariff.

totalPriceFloat

Total price of all tariffs.

totalCurrencyString

The totalCurrency field specifies the currency in which the total price is calculated.

transitTimeobject

The transitTime field contains information about the time taken for the transportation.
Fields: rate (Int), port (Int), route (Int).

Generalobject

General rate information.
Fields: shipmentId (String), validityFrom (String), validityTo (String), individual (Boolean), totalPrice (Float), totalCurrency (String), totalCo2 (object), totalTransitTime (Int), alternative (Boolean), expired (Boolean), spaceGuarantee (Boolean), spot (Boolean), indicative (Boolean), queryShippingType (enum).

shipmentIdString

The shipmentId field is a unique identifier for the rate.

validityFromString

The validityFrom field specifies the date from which the rate becomes valid.
Format: YYYY-MM-DD

validityToString

The validityTo field specifies the date until which the rate is valid.
Format: YYYY-MM-DD

individualBoolean

The individual field indicates whether the rate is individual.

totalPriceFloat

Total rate price. Includes all points prices.

totalCurrencyString

The totalCurrency field specifies the currency in which the total price is calculated.

totalCo2object

Includes total amount and price of all points CO2 emissions. contains next fields:
amount: Float Amount of co2 emissions.
price: Float Price for co2 emissions.

totalTransitTimeInt

The totalTransitTime field contains information about total sum of all points transit times.

alternativeBoolean

The alternative field indicates whether the rate is alternative.

expiredBoolean

The expired field indicates whether the rate is expired.

spaceGuaranteeBoolean

The spaceGuarantee field indicates whether the rate is space guarantee.

spotBoolean

The spot field indicates whether the rate is spot.

indicativeBoolean

The indicative field indicates whether the rate is indicative.

queryShippingTypeenum

Requested shipping type. Could be one of the next:
FCL
LCL
BULK
FTL
LTL
LAND_FCL
RAIL_FCL
AIR