SHshipoway
Shipper API

Get a quote by your own customer reference

Returns the newest quote your company holds under a customer reference: your own identifier for a load, such as the load number on a daily manifest.

Read this before tendering a load whose tender cannot carry an Oway quote ID. matchable is true when the quote will back the booking as it stands: open, inside its 48-hour window, and carrying a price you can be charged.

A load whose quote is missing, expired, or no longer matches the freight is still worth tendering. We re-price it and book at the new price rather than refusing it, and flag the difference for our operations team.

Note: The reference is scoped to the company behind your API key. A reference another company uses for a different load is never returned to you.

get/v1/shipper/quotes/by-reference

Request

  • Base URL
    https://api.oway.io
  • URL
    https://api.oway.io/v1/shipper/quotes/by-reference
  • Auth
    HTTP bearer and API key in header x-oway-api-key

Query parameters

referencestring required

Your own identifier for the load, as sent on the quote request

Response

Quote found

quoteIdstring

Oway's quote ID.

customerReferencestring

The reference you asked for, as stored on the quote.

statusstring

Quote status. OPEN is the only status that can back a booking.

priceCentsinteger

All-in price in cents. Omitted when the quote carries no price you can book at (for example a lane we could not serve).

validUntilstring date-time

When the quote stops being bookable. 48 hours after it was issued.

originZipstring

Origin ZIP the quote was priced for.

destinationZipstring

Destination ZIP the quote was priced for.

palletsinteger

Pallet positions the quote was priced for.

weightLbsnumber float

Total weight in pounds the quote was priced for.

expiredboolean

True once validUntil has passed.

matchableboolean

True when this quote will back a tender as it stands: open, unexpired, and priced. When false, tender anyway if you want the load moved: we re-price it and book at the new price rather than refusing it.

Example response

{
  "quoteId": "QT-8F3K29XA",
  "customerReference": "2835391",
  "status": "OPEN",
  "priceCents": 123400,
  "validUntil": "2026-09-25T16:05:00Z",
  "originZip": "91730",
  "destinationZip": "95206",
  "pallets": 12,
  "weightLbs": 18400,
  "matchable": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.