v1
latestOpenAPI 3.0.32026-07-23273969.2 KBSearch facilities by name, address, zip code, city/state, website domain, or coordinates
Unified facility search. Provide at least one of: non-empty name, non-empty address, zip_code, non-empty website_domain, or both city and state (then use radius around the geocoded point). You may also pass location as latitude,longitude for radius search instead of city/state. Optionally include lane data per facility with include_lanes=true. Lanes can be filtered by min_distance (miles from facility) and direction (compass direction). Filters are applied before the top_n limit.
Pagination
When results exceed 100 facilities, the response is paginated using opaque cursor-based pagination. The Link response header contains a next-page URL with a cursor parameter. Follow that URL to retrieve subsequent pages. The X-Total-Count header shows the total matching facilities across all pages. Pagination is not supported with smart_search=true. See component schema FacilitiesQueryCriteria for the full parameter model and validation shape. Historical path /find_facilities exposes the same search behavior and is documented here as /facilities for a single contract.
Query parameters
Facility or collection name (optional if address, both city and state, or website_domain are provided). See FacilitiesQueryCriteria for validation rules.
Substring match on formatted address (optional if name, both city and state, or website_domain are provided).
City; use with state for geocoded radius search unless name, address, or website_domain alone is sufficient.
State; use with city unless name, address, or website_domain supplies the search mode.
Substring match against the shipper's contact_url. Must include the TLD (e.g. acme.com). Optional path tails (acme.com/about) are accepted by the validator but the path is stripped before matching — only the host is searched.
Mutually exclusive with name and address. If name or address is also supplied, website_domain is silently ignored (see FacilitiesQueryCriteria → Filter precedence). Also ignored when smart_search=true is used together with name.
Comma-separated latitude,longitude; radius applies around this point when provided instead of city/state.
Search radius in miles around the geocoded city/state point or location
Lot size category filter
Maximum number of facilities to return
Optional place category filter (pipe-separated values accepted by the service)
Optional intermodal drayage filter flag
Include inbound and outbound lane data for each facility. Lanes are ranked by weight.
Number of top lanes to return per direction (inbound/outbound) per facility.
Minimum distance in miles from the facility to a lane destination. Lanes closer than this distance are excluded. Applied before top_n.
Filter lanes by compass direction from the facility. Applied before top_n.
US zip code; searches facilities near the zip centroid.
Opaque pagination cursor from the Link header of a previous response. When results exceed 100 facilities, the server returns a Link header containing a next-page URL with this cursor embedded. Follow that URL to retrieve subsequent pages. Do not construct or parse this value — it is server-controlled and opaque.
Headers
application/json
Access Token for authentication
X api key for authentication
Response
List of facilities