---
title: "Search offers"
method: GET
path: "/api/v2/load-offers/offers"
tags: ["Load Offers"]
---

# Search offers

`GET /api/v2/load-offers/offers`

Search offers

## Query parameters

- `alcohol` string, boolean — Show only loads that have/don't have alcoholic commodity (shows all loads if not informed)
- `equipment_type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK' | 'LTL' | 'BLK' | 'TNK' | 'OTH' — The type of truck used to transport the load: * `DRV` - Dry van * `FBE` - Flatbed * `RFR` - Reefer * `CON` - Conestoga * `CUR` - Curtainside * `DDP` - Double drop * `IMC` - Intermodal * `SDK` - Step deck * `STK` - Straight truck * `LTL` - Less than truckload * `BLK` - Bulk * `TNK` - Tanker * `OTH` - Others Repeat the query string in order to search for multiple types at the same time, e.g: `?equipment_type=DRV&equipment_type=FBE`
- `start_date` string, YYYY-MM-DD — Date
- `end_date` string, YYYY-MM-DD — Date
- `origin_lat` number — Origin latitude
- `origin_lon` number — Origin longitude
- `origin_radius` number — Radius for origin field (Miles)
- `destination_lat` number — Destination latitude
- `destination_lon` number — Destination longitude
- `destination_radius` number — Radius for destitation field (Miles)
- `mc` string — Carrier's MC number
- `dot` string — Carrier's DOT number

## Response `200`

Success

- object
  - `count` number — Number of objects found
  - `next` string, url — URL for next page of results
  - `previous` string, url — URL for previous page of results
  - `results` object[]
    - `id` string — Offer unique identifier (UUID)
    - `price` number — Offer price (USD)
    - `load` object
      - `equipment_type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK' | 'LTL' | 'BLK' | 'TNK' | 'OTH', required — The type of truck used to transport the load. Allowed values are DRV (dry van), FBE (flatbed), RFR (reefer), CON (conestoga), CUR (curtainside), DDP (double drop), IMC (intermodal), SDK (step deck), STK (straight truck), LTL (less than truckload), BLK (bulk), TNK (tanker) and OTH for others.
      - `commodity` string — Name or description of the commodity that is being shipped.
      - `weight` number — Weight of the cargo in pounds (lbs).
      - `dimensions` object — Dimensions of the cargo in feet (ft). A `null` dimension means that the information is unavailable.
        - `weight` number, nullable
        - `height` number, nullable
        - `width` number, nullable
      - `distance` number — Total distance of the shipment, in miles. This counts all stops.
      - `stops` object[]
        - `type` 'PU' | 'DEL' — Type of the stop. Pickup (PU) or Delivery (DEL).
        - `address` string
        - `city` string
        - `state` string — Up to 3-alphanumeric characters representing state or equivalent administrative boundary, from the second part of ISO 3166-2 code definition. For example, Florida is FL, since its ISO 3166-2 is US-FL.
        - `country` string — 3 letter country code (ISO-3166-1 alpha3).
        - `latitude` number — Latitude coordinate of the stop
        - `longitude` number — Longitude coordinate of the stop
        - `zipcode` string — Zipcode of the stop (first five digits)
        - `window_start` string, naive date-time — A datetime that represents the start of a time window for this stop (pickup or delivery). In local time.
        - `window_end` string, naive date-time — A datetime that represents the start of a time window for this stop (pickup or delivery). In local time.
        - `window_timezone` string — A timezone identifier for the stop.
        - `requirements` unknown[] — A list of requirements for the Stop, such as drop_trailer, etc.
          - unknown
        - `facility_info` object — Detention rate and average waiting time on the facility
          - `avg_time_spent` object — Average waiting on facility
            - `pickup` number — Average waiting time in minutes for pickup
            - `delivery` number — Average waiting time in minutes for delivery
          - `detention_rate` number — Facility detention rate (0 to 100)
      - `requirements` object — Requirements for the load
        - `beer` boolean
        - `chemicals` boolean
        - `ctpat` boolean
        - `food_grade` boolean
        - `frozen` boolean
        - `hazmat` boolean
        - `hvhr` boolean
        - `pharmaceuticals` boolean
        - `produce` boolean
        - `teams` boolean
        - `tsa` boolean
        - `twic` boolean
        - `vented_vans` boolean
      - `ref_number` string, required — Human readable Load reference number.
    - `actions` object
      - `redirect_url` string — URL of offer on Loadsmart website.
      - `accept_url` string — URL to accept the offer via API (must be a POST method).

## Other responses

- `400` — Invalid parameters

---

[API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)