> ## 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.

# Book a parcel shipment

> Book a parcel shipment using a rate ID from a parcel rate request. Returns tracking numbers and labels.



## OpenAPI

````yaml openapi.json post /book/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:
  /book/parcel:
    post:
      tags:
        - Booking
      summary: Book a parcel shipment
      description: >-
        Book a parcel shipment using a rate ID from a parcel rate request.
        Returns tracking numbers and labels.
      operationId: bookParcelShipment
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - id
                - rateId
              properties:
                id:
                  type: string
                  description: Quote ID from the parcel rate response
                rateId:
                  type: string
                  description: Rate ID of the selected parcel rate
                originCompany:
                  type: string
                originAddress:
                  type: string
                originContactName:
                  type: string
                originContactPhone:
                  type: string
                originContactEmail:
                  type: string
                  format: email
                destCompany:
                  type: string
                destAddress:
                  type: string
                destContactName:
                  type: string
                destContactPhone:
                  type: string
                destContactEmail:
                  type: string
                  format: email
      responses:
        '200':
          description: Parcel shipment booked successfully
        '400':
          description: Bad request
        '401':
          description: Authentication failed
        '429':
          description: Rate limit exceeded
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your ShipPeek API token in the format `client_id.client_secret`.

````