> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shippeek.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get LTL rates

> Get LTL shipping rates from all configured carriers. Returns a list of rates sorted by price. Each rate includes carrier details, transit time, and an itemized charge breakdown.



## OpenAPI

````yaml openapi.json post /rates
openapi: 3.0.0
info:
  title: ShipPeek API
  version: 1.0.0
  description: Multi-carrier shipping rate aggregation, booking, and tracking API.
  contact:
    name: ShipPeek API Support
    email: yash@shippeek.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://shippeek.com/terms
servers:
  - url: https://api.shippeek.dev
    description: Sandbox
  - url: https://api.shippeek.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Rates
    description: Get shipping rates from multiple carriers
  - name: Booking
    description: Book shipments and manage pickups
  - name: Tracking
    description: Track shipments by PRO or tracking number
  - name: Shipments
    description: Retrieve and search shipment data
paths:
  /rates:
    post:
      tags:
        - Rates
      summary: Get LTL rates
      description: >-
        Get LTL shipping rates from all configured carriers. Returns a list of
        rates sorted by price. Each rate includes carrier details, transit time,
        and an itemized charge breakdown.
      operationId: getLtlRates
      parameters:
        - name: timeout
          in: query
          description: >-
            How long to wait for rates (seconds). Use `1` to create a quote
            without waiting for all carriers.
          schema:
            type: integer
            minimum: 1
            maximum: 30
            default: 30
        - name: carriers
          in: query
          description: Comma-separated list of carrier SCAC codes to filter results.
          schema:
            type: array
            items:
              type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - originPostalCode
                - destPostalCode
                - items
              properties:
                pickupDate:
                  type: string
                  format: date
                  description: Requested pickup date (YYYY-MM-DD)
                charges:
                  type: array
                  items:
                    type: string
                    enum:
                      - arrival notice
                      - arrival schedule
                      - liftgate pickup
                      - liftgate delivery
                      - inside pickup
                      - inside delivery
                      - sort and segregate
                      - protect from freezing
                  description: Accessorial charges to include in the rate
                originCompany:
                  type: string
                  description: Company name at pickup
                originAddress:
                  type: string
                  description: Street address at pickup
                originAddress2:
                  type: string
                originCity:
                  type: string
                originState:
                  type: string
                originPostalCode:
                  type: string
                  description: Pickup ZIP code
                originCountry:
                  type: string
                  enum:
                    - USA
                    - CAN
                  default: USA
                originType:
                  type: string
                  enum:
                    - business dock
                    - business no dock
                    - residential
                    - limited access
                    - trade show
                    - construction
                    - farm
                    - military
                    - airport
                    - place of worship
                    - school
                    - mine
                    - pier
                  default: business dock
                  description: Facility type at pickup location
                destCompany:
                  type: string
                destAddress:
                  type: string
                destAddress2:
                  type: string
                destCity:
                  type: string
                destState:
                  type: string
                destPostalCode:
                  type: string
                  description: Delivery ZIP code
                destCountry:
                  type: string
                  enum:
                    - USA
                    - CAN
                  default: USA
                destType:
                  type: string
                  enum:
                    - business dock
                    - business no dock
                    - residential
                    - limited access
                    - trade show
                    - construction
                    - farm
                    - military
                    - airport
                    - place of worship
                    - school
                    - mine
                    - pier
                  default: business dock
                  description: Facility type at delivery location
                items:
                  type: array
                  items:
                    $ref: '#/components/schemas/RateItem'
                  description: Items being shipped
      responses:
        '200':
          description: Rates returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Quote ID for retrieving rates later
                  rates:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rate'
                  links:
                    type: object
                    properties:
                      ratesUrl:
                        type: string
                      spotUrl:
                        type: string
              example:
                id: 570665116d0bfce422911668
                rates:
                  - id: 34575116d0afce4229116467
                    status: ok
                    mode: LTL
                    paymentTerms: Outbound Prepaid
                    total: 123.45
                    ref: ABC123456
                    days: 3
                    serviceType: Standard
                    serviceDescription: Standard
                    time: 530
                    carrierId: 84528496d0afce4229282716
                    carrier: Estes Express Lines
                    carrierCode: exla
                    charges:
                      - name: linehaul
                        amount: 1000
                      - name: discount
                        amount: -900
                      - name: fuel
                        amount: 23.45
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Invalid or missing API key
        '429':
          description: Rate limit exceeded (30 requests/minute)
components:
  schemas:
    RateItem:
      type: object
      required:
        - weight
        - freightClass
      properties:
        weight:
          type: number
          description: Weight in pounds
        freightClass:
          type: number
          description: NMFC freight class (50-500)
          enum:
            - 50
            - 55
            - 60
            - 65
            - 70
            - 77.5
            - 85
            - 92.5
            - 100
            - 110
            - 125
            - 150
            - 175
            - 200
            - 250
            - 300
            - 400
            - 500
        length:
          type: number
          description: Length in inches
        width:
          type: number
          description: Width in inches
        height:
          type: number
          description: Height in inches
        quantity:
          type: integer
          description: Number of handling units
          default: 1
        description:
          type: string
          description: Item description
        package:
          type: string
          description: Packaging type
        hazardous:
          type: boolean
          description: Whether this item is hazardous
          default: false
        nmfc:
          type: string
          description: NMFC code
    Rate:
      type: object
      properties:
        id:
          type: string
          description: Rate ID used for booking
        status:
          type: string
          enum:
            - ok
            - error
          description: Whether the rate was successfully retrieved
        mode:
          type: string
          enum:
            - LTL
            - Parcel
        paymentTerms:
          type: string
          description: Payment terms for this rate
        total:
          type: number
          description: Total cost in USD
        ref:
          type: string
          description: Carrier reference number
        days:
          type: integer
          description: Estimated transit days
        serviceType:
          type: string
          description: Service level
        serviceDescription:
          type: string
        time:
          type: integer
          description: Time in milliseconds the carrier took to respond
        carrierId:
          type: string
        carrier:
          type: string
          description: Carrier name
        carrierCode:
          type: string
          description: Carrier SCAC code
        charges:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              amount:
                type: number
          description: Itemized charge breakdown
        bookUrl:
          type: string
          description: URL to book this rate
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        message:
          type: string
          description: Detailed error description
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your ShipPeek API token in the format `client_id.client_secret`.

````