API Update: Pickup Request Dimensions and Quote Number

| 03 March 2026 | Category: Release Notes

R+L Carriers API – Release Notes
Pickup Request API Enhancements
Release Date: March 2026

Overview

This release introduces enhancements to the Pickup Request API to improve shipment visibility and operational efficiency. Two new fields have been added to support more detailed shipment information and better communication with drivers at the time of pickup.

New Features

1. Dimensions Array (Destinations Level)

A new Dimensions array has been added under each object within the Destinations array. This allows customers to provide detailed dimensional data for each shipment.

Location:
Pickup → Destinations[] → Dimensions[]

Structure:

"Destinations": [
  {
    "Weight": 0,
    "Pieces": 0,
    "PackageType": "SKD",
    "Dimensions": [
      {
        "Units": 0,
        "Width": 0,
        "Height": 0,
        "Length": 0
      }
    ],
    "City": "string",
    "StateOrProvince": "string",
    "ZipOrPostalCode": "string",
    "CountryCode": "USA"
  }
]

Details:

  • Supports multiple dimension entries per destination.

  • Provides drivers with accurate shipment size information at the time of pickup.

  • Improves planning, handling, and equipment allocation.

2. Quote Number Field

A new QuoteNumber field has been added to the main Pickup object to allow customers to associate a pickup request with a previously generated quote.

Location:
Pickup → QuoteNumber

Structure:

"QuoteNumber": "string"

Details:

  • Enables linkage between pickup requests and pricing quotes.

  • Supports improved tracking and validation of quoted shipments.

  • Works alongside existing ExpeditedQuoteNumber field.

Additional Behavior

When the Dimensions and/or QuoteNumber fields are provided, the AdditionalInstructions field will be automatically populated with a summary of the dimensional data.

Example:

AdditionalInstructions: DIMENSIONS PER PICKUP: 44 L 22 W 33 H DIMENSIONS PER QUOTE: 44 L 22 W 33 H

This ensures that critical dimensional details are clearly communicated to drivers at the time of pickup.

Updated Request Structure (Excerpt)

{
  "Pickup": {
    ...
    "Destinations": [
      {
        "Weight": 0,
        "Pieces": 0,
        "PackageType": "SKD",
        "Dimensions": [
          {
            "Units": 0,
            "Width": 0,
            "Height": 0,
            "Length": 0
          }
        ],
        "City": "string",
        "StateOrProvince": "string",
        "ZipOrPostalCode": "string",
        "CountryCode": "USA"
      }
    ],
    ...
    "ExpeditedQuoteNumber": "string",
    "QuoteNumber": "string",
    "AdditionalInstructions": "string",
    ...
  },
  "SendEmailConfirmation": true
}

Impact & Compatibility

  • These enhancements are backward compatible.

  • Existing integrations will continue to function without modification.

  • The new fields are optional but recommended for improved service accuracy.

Benefits

  • Enhanced visibility of shipment dimensions for pickup drivers.

  • Improved operational efficiency and planning.

  • Better alignment between quoted and requested shipments.

  • Increased data accuracy at the time of pickup.

Action Required

No immediate action is required. Clients are encouraged to begin populating the new fields to take full advantage of these enhancements.

For additional information or support, please contact the R+L Carriers API Support team.