---
title: "Get carrier recommendations based on location"
method: GET
path: "/carrier/recommendations"
---

# Get carrier recommendations based on location

`GET /carrier/recommendations`

## Query parameters

- `origin_city` string, required
- `origin_state` string, required
- `destination_city` string, required
- `destination_state` string, required
- `origin_radius` number
- `destination_radius` number
- `carrier_score_min` unknown
- `carrier_score_max` unknown
- `fleet_size_min` number
- `fleet_size_max` number
- `carried_cargo` string
- `equipment_types` string
- `preferred_carriers` boolean
- `real_time` boolean
- `auth_months_min` number
- `power_only` boolean
- `broker_authority` boolean
- `is_possible_backhaul` boolean

## Headers

- `accept` string, required
- `Access-Token` string, required
- `x-api-key` string, required

## Response `200`

The JSON response containing recommendations and lane volume

- CarrierResponse
  - `real_time_locs` CarrierRealTimeLocs[], required
    - `current_lat` number, nullable
    - `current_lon` number, nullable
    - `dot_number` string, required
    - `is_inbound` boolean, required
  - `recommendations` CarrierRecommendation[], required
    - `add_date` string, required
    - `bipd_insurance_on_file` number, required
    - `cargo_insurance_on_file` number, required
    - `carried_cargo` string, required
    - `carrier_driver_oos_rate` number, required
    - `carrier_driver_oos_rate_national_avg` number, required
    - `carrier_score_scaled` number, required
    - `carrier_total_power_units` number, required
    - `carrier_vehicle_oos_rate` number, required
    - `carrier_vehicle_oos_rate_national_avg` number, required
    - `confirmed_email` object, required
      - `<email@domain.com>` object
        - `add_date` string
    - `confirmed_phone` object, required
      - `<phone_number>` object
        - `add_date` string
    - `dba_name` string, nullable
    - `dot_number` string, required
    - `email_address` string, required
    - `is_inbound` boolean, required
    - `is_real_time` boolean, required
    - `is_visually_sighted` boolean, required
    - `is_possible_backhaul` boolean
    - `lat` number, nullable
    - `legal_name` string, required
    - `lon` number, nullable
    - `mc_number` number, required
    - `phy_city` string, required
    - `phy_state` string, required
    - `phy_street` string, required
    - `phy_zip` string, required
    - `telephone` string, required
    - `power_only` boolean
    - `broker_authority_status` string

---

[API](https://skmtc.net/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.net/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/versions/bf34c2431a21/schema)