Skip to main content
The optional filters block restricts which of a customer’s service mappings are priced. Filter by the same values you see in the response — service and rate card are matched by their alias (serviceId / rateCardId).

Dimensions

string[]
Restrict to services supplied by these carriers, matched by carrier alias.
string[]
Restrict to these services, matched by service alias — the same value returned as serviceId on each quote line (e.g. ZEPHYR, FALCON).
string[]
Restrict to these rate cards, matched by rate-card alias — the same value returned as rateCardId (e.g. ZEPHYR_EXP, FALCON_STD).
string[]
Restrict to these service types, e.g. DOMESTIC, INTERNATIONAL.
string[]
Restrict to these service classes, e.g. STANDARD, EXPRESS.

How matching works

Empty = no restriction

An empty or omitted array places no restriction on that dimension. Omit filters entirely to price everything.

AND across, OR within

A rate card is priced only if it satisfies every non-empty dimension; within one dimension, matching any listed value passes.

Example — combine dimensions

Price only the Zephyr service and the ZEPHYR_EXP rate card:

Example — several services

Price Zephyr or Falcon (drops everything else):
If a filter matches nothing, that customer’s quotes array comes back empty (and noQuoteMessage may explain why) — the request still succeeds.