---
title: "ListingPriceRequest"
url: "https://api-docs.centraldispatch.com/apis/market-intelligence-api-1-0-0/versions/3fc04e8d-bb56-47cd-b2e7-3130bc01a22e/schemas/ListingPriceRequest"
---

> Full API specification: https://api-docs.centraldispatch.com/apis/market-intelligence-api-1-0-0/versions/3fc04e8d-bb56-47cd-b2e7-3130bc01a22e.md

# ListingPriceRequest

Details of listing prices.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Market Intelligence API
  version: 1.0.0
servers:
  - url: https://api.centraldispatch.com
    description: Production server
components:
  schemas:
    Stop:
      type: object
      properties:
        stopNumber:
          type: integer
          description: The sequential number of the stop along the route e.g. 1 is the
            pick up stop and 2 is the delivery stop.
          format: int32
          example: 1
        streetAddress1:
          type: string
          description: The street address.
          nullable: true
          example: 345 W Elm St.
        streetAddress2:
          type: string
          description: Additional street address line.
          nullable: true
          example: 2nd Floor
        city:
          type: string
          description: The city. Required if valid `latitude` and `longitude` are not
            provided.
          nullable: true
          example: Anaheim
        state:
          type: string
          description: The state. Required if valid `latitude` and `longitude` are not
            provided.
          nullable: true
          example: CA
        country:
          type: string
          description: The country code. US or CA.
          nullable: true
          example: US
        postalCode:
          type: string
          description: The ZIP code. Must be a valid United States ZIP code or Canadian
            postal code.
          nullable: true
          example: "92802"
        latitude:
          type: number
          description: The latitude of the location. Required if valid `city` and `state`
            are not provided.
          format: double
          nullable: true
          example: 33.81228788622535
        longitude:
          type: number
          description: The longitude of the location. Required if valid `city` and `state`
            are not provided.
          format: double
          nullable: true
          example: -117.91836265987132
      description: Details of a stop.
    Vehicle:
      type: object
      properties:
        vin:
          type: string
          description: The vehicle identification number (VIN). Required if valid `year`,
            `make` and `model` are not provided.
          nullable: true
          example: KL8CH6SA6NC001234
        year:
          type: string
          description: The 4 digit year of the vehicle. Required if valid `vin` is not
            provided.
          nullable: true
          example: "2022"
        make:
          type: string
          description: The manufacturer's make of the vehicle. Required if valid `vin` is
            not provided.
          nullable: true
          example: Chevrolet
        model:
          type: string
          description: The manufacturer's model of the vehicle. Required if valid `vin` is
            not provided.
          nullable: true
          example: Spark
        isOperable:
          type: boolean
          description: Limit search to operable vehicles.
          default: false
          example: true
        pickupStopNumber:
          type: integer
          description: The stop number where the vehicle will be picked up. Origin stop
            number from the stops array.
          format: int32
          example: 1
        dropOffStopNumber:
          type: integer
          description: The sequential stop number where the vehicle will be delivered.
            Destination stop number from the stops array.
          format: int32
          example: 2
        vehicleType:
          type: string
          description: The type of vehicle e.g. CAR, PICKUP, SUV.
          example: CAR
      description: Details of a vehicle.
    ListingPriceRequest:
      type: object
      properties:
        stops:
          type: array
          items:
            $ref: "#/components/schemas/Stop"
          description: A collection of stops. A minimum of 2 stops (pick up and delivery)
            must be sent. Either address data or latitutude/longitude are
            required.
        vehicles:
          type: array
          items:
            $ref: "#/components/schemas/Vehicle"
          description: A collection of vehicles. Either `VIN` or YMM is required.
        isEnclosed:
          type: boolean
          description: Limit search to enclosed trailers.
          default: false
          example: true
        enforceEnclosedOnly:
          type: boolean
          description: When `true`, strictly limits search results to fully enclosed items
            only. By default, the search relaxes enclosed requirements to
            improve match rates, but enabling this flag ensures no non-enclosed
            results are returned.
          default: false
          nullable: true
          example: true
        limit:
          maximum: 5
          minimum: 1
          type: integer
          description: The maximum number of items to be returned in the response.
          format: int32
          default: 5
          nullable: true
          example: 1
        dateSince:
          type: string
          description: The earliest creation date for comparable listings to include in
            results. Accepts any date between today and the last 365 days. If
            not provided, defaults to 365 days ago, in UTC/ISO 8601 format.
          format: date-time
          nullable: true
          example: 2026-03-20T00:00:00Z
      description: Details of listing prices.
```