> ## 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 parcel rates

> Get parcel shipping rates from UPS and FedEx. Returns service options with pricing and transit times.



## OpenAPI

````yaml openapi.json post /rates/parcel
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/parcel:
    post:
      tags:
        - Rates
      summary: Get parcel rates
      description: >-
        Get parcel shipping rates from UPS and FedEx. Returns service options
        with pricing and transit times.
      operationId: getParcelRates
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - originPostalCode
                - destPostalCode
                - items
              properties:
                pickupDate:
                  type: string
                  format: date
                charges:
                  type: array
                  items:
                    type: string
                    enum:
                      - signature required
                      - adult signature required
                      - indirect signature required
                  description: Parcel-specific accessorial charges
                originPostalCode:
                  type: string
                originCountry:
                  type: string
                  enum:
                    - USA
                    - CAN
                  default: USA
                originType:
                  type: string
                  enum:
                    - business dock
                    - business no dock
                    - residential
                  default: business dock
                destPostalCode:
                  type: string
                destCountry:
                  type: string
                  enum:
                    - USA
                    - CAN
                  default: USA
                destType:
                  type: string
                  enum:
                    - business dock
                    - business no dock
                    - residential
                  default: business dock
                schedulePickup:
                  type: boolean
                  description: Whether to include pickup scheduling with the booking
                  default: false
                items:
                  type: array
                  items:
                    type: object
                    required:
                      - weight
                    properties:
                      weight:
                        type: number
                        description: Weight in pounds
                      length:
                        type: number
                        description: Length in inches
                      width:
                        type: number
                        description: Width in inches
                      height:
                        type: number
                        description: Height in inches
                      quantity:
                        type: integer
                        default: 1
                      package:
                        type: string
                        description: >-
                          Packaging type (Custom, or carrier-specific like
                          FedEx-pak, UPS-letter)
                        default: Custom
      responses:
        '200':
          description: Parcel rates returned successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  rates:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rate'
        '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
components:
  schemas:
    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`.

````