Skip to main content
POST
List Shipper Quotes

Authorizations

x-arms-api-key
string
header
required
x-arms-assume-user
string
header
required

Body

application/json
aar_car_type_pattern
string

Optional exact AAR/UMET car type pattern (for example "A-4" for plug doors) used for quote equipment assumptions and ARCT condition evaluation.

car_types
enum<string>[]

Optional car type overrides used for rating/equipment assumptions. Deprecated for new clients in favor of equipment_profiles, which also supports special quote-only types and additional measurement ranges. When provided, quote search matches rates for any selected car type.

Available options:
ALL_CAR_TYPES,
BI_LEVEL,
BOX_CAR,
BULKHEAD,
CLOSED,
CLOSED_BI_LEVEL,
CLOSED_TRI_LEVEL,
COIL,
COVERED_COIL,
COVERED_GONDOLA,
CUSHIONED_BOX_CAR,
FLAT_PEDESTAL,
GONDOLA,
GRAVITY_FLOW,
INSULATED_BOX_CAR,
MECHANICAL_REFRIGERATOR,
OPEN,
OPEN_COIL_CARS,
OPEN_GONDOLA,
OPEN_HOPPER,
PLUG_DOORS,
TRI_LEVEL,
TRIPLE_CROSS_HOPPER
contents
object
contract_cifs
string[]

Contract CIF filters. If provided, matching contract quotes are included in addition to tariff results.

destination
object
destination_cifs
string[]

Customer CIFs at the destination; SCRS counterpart of origin_cifs for destinations.

destination_unknown
boolean

Rule 11 segment pricing counterpart of origin_unknown: continuation beyond the destination gateway is unknown and unpriced. Same geography handling and junction-narrowing as origin_unknown. Requires method_of_payment = RULE_11.

destinations
object[]

List of candidate destination locations. Prefer this over the single destination input.

equipment_ownership_statuses
enum<string>[]

Optional equipment ownership status filters. When provided, quote search matches rates whose EQOS conditions include any of the selected statuses.

Equipment ownership status categories used in EQOS shipment conditions.

  • HIGHWAY_CARRIER: H - Highway carrier
  • SHIPPER_OWNED_OR_LEASED: S - Shipper owned or leased
  • STEAMSHIP_LINES: O - Steamship lines
  • RAILROAD_OWNED_OR_LEASED: R - Railroad owned or leased
Available options:
HIGHWAY_CARRIER,
SHIPPER_OWNED_OR_LEASED,
STEAMSHIP_LINES,
RAILROAD_OWNED_OR_LEASED
equipment_profiles
object[]

Optional equipment profile filters. When provided, quote search matches rates for any selected profile.

exclude_carriers
string[]

Carriers (reporting marks / SCAC, for example "BNSF", "UP") to exclude from routing. Any candidate route that involves one of these carriers on any leg is dropped from the results. Empty means no carrier exclusion is applied. Compared case-insensitively.

exclude_junctions
string[]

Junction / gateway codes (for example "DIANN") to exclude from routing. Any candidate route that interchanges through one of these junctions is dropped from the results. Empty means no junction exclusion is applied. Compared case-insensitively.

method_of_payment
enum<string>
Available options:
PREPAID,
COLLECT,
RULE_11
number_of_cars
integer<int32>

Number of cars requested for the movement. Omitted/0 defaults to 1.

origin
object
origin_cifs
string[]

Customer CIFs at the origin. When provided, candidate origin stations are filtered to those onto which at least one of these customers may switch traffic under SCRS (Serving Carrier Reciprocal Switch) rules. Empty means no SCRS origin restriction is applied.

origin_unknown
boolean

Rule 11 segment pricing: the true origin of the movement is unknown; the origin geographies (any supported form — city/state, FSAC, SPLC, or junction) locate the KNOWN gateway where the movement enters the priced portion. The location is narrowed to its stations at an interchange junction; a location with no junction station fails with INVALID_ARGUMENT (LOCATION_HAS_NO_GATEWAY). The priced portion is rated as part of a larger Rule 11 move arriving via that gateway (prior movement unpriced). Requires method_of_payment = RULE_11. May be combined with destination_unknown to price a bridge segment between two gateways.

origins
object[]

List of candidate origin locations. This should be at most a handful, preferably fewer than 10. Prefer this over the single origin input.

route
object
ship_date
string

Desired shipment date used for applicability/rating in ISO8601 format. Use YYYY-MM-DD (for example: "2026-03-03").

Response

A successful response.

quotes
object[]

Candidate quotes returned for the request.