---
title: "Search loads"
method: GET
path: "/api/v1/Loads/search"
tags: ["Shipper - Shipment APIs"]
---

# Search loads

`GET /api/v1/Loads/search`

Based on a given search term, Coyote will return a list of all loads that match on any of the below reference number types associated to your loads.
```
ReferenceNumberType: 
    - "PRONumber"
    - "DeliveryNumber"
    - "AppointmentConfirmation"
    - "ProofOfDelivery"
    - "Reference"
    - "PoNumber"
    - "OrderNumber"
    - "CommercialInvoice" 
    - "ShipmentNumber" 
    - "MasterBillOfLading" 
    - "BillOfLading" 
    - "PickupNumber"
```

## Query parameters

- `searchTerm` string, required — Requested search term

## Response `200`

Loads successfully retrieved and returned

- CoyoteSystemsExternalApiContractsModelsLoadSearchLoadSearchResult[]
  - `loadId` integer — Coyote load Id
  - `loadDate` string, date-time — Load date
  - `loadStops` CoyoteSystemsExternalApiContractsModelsLoadSearchLoadStop[], nullable — Load stops
    - `sequence` integer — Stop sequence
    - `stopType` string, nullable — Stop type
    - `facility` CoyoteSystemsExternalApiContractsModelsLoadSearchFacility — Load stop facility
      - `name` string, nullable — Name
      - `address` CoyoteSystemsExternalApiContractsModelsLoadSearchAddress — Address
        - `line1` string, nullable — Line 1
        - `line2` string, nullable — Line 2
        - `line3` string, nullable — Line 3
        - `cityName` string, nullable — City name
        - `countryCode` string, nullable — Country code
        - `postalCode` string, nullable — Postal code
        - `stateProvinceCode` string, nullable — State or province code
      - `geoCoordinates` CoyoteSystemsExternalApiContractsModelsLoadSearchGeoCoordinates — Geo coordinates
        - `latitude` number, double, nullable — Latitude
        - `longitude` number, double, nullable — Longitude
  - `trackingUrl` string, uri, nullable — Tracking Url

## Other responses

- `204` — Loads do not exist for given search term
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/coyote/apis/coyotego-api.md) · [All operations](https://skmtc.net/coyote/apis/coyotego-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coyote/coyotego-api/versions/1d3005ca5ad5/schema)