Pinnacle Logistics Group API Documentation Powered by

Pinnacle Logistics API

Powered by Priority1

Rate, book, track and pull documents for your freight.

You can be looking at live rates on your own account in about a minute. No install, no setup — just your API key and the button below.

Get your first quote

Three steps. Everything runs right here in your browser.

1

Paste your API key

Your Pinnacle rep sent this to you. It starts with p1_live_ (or p1_test_ for a test key). It is stored only in this browser.

Test keys: quotes and invoices are real. Bookings are checked and answered just like live ones, with a BOL number starting 99, a TEST- pickup number and a BOL PDF marked TEST, but nothing is sent to a carrier, nothing is picked up and nothing is billed. Tracking, documents, references and cancel work on those test bookings.

2

Run a sample quote

Every field a rate request actually takes is below, pre-filled with a working example: one pallet, 275 lbs, Little Rock to Chicago. Change anything, add more line items, or open More options for the fields you can leave out.

3

Copy the code into your system

The exact request you just ran, in your language, with your key already filled in.

Verify your key above to fill in these samples.

Code samples

Every endpoint below has a Show code button that generates a working snippet in any of these languages, using whatever values you have typed into the form. If you just want a ready-made collection:

Includes every endpoint, pre-authenticated with your key.

How the API works

Base URL

Authentication

Send your key in an X-API-KEY header on every request. There is no login, no token exchange, and nothing expires.

Every request looks the same

Rate limits

Each key has a limit per minute, per hour and per day, counted separately for each kind of request. Reaching the quote limit does not stop you tracking or booking.

Kind of requestPer minutePer hourPer day
Quotes
LTL rates, TL rates, suggested class
50200500
Booking and changes
book, cancel, add a reference, import
530100
Tracking and documents
shipment status, BOL / POD / invoice images, invoices
603005,000

These are the standard limits. Yours are shown when you verify your key at the top of this page, and /v2/key-info returns them as rateLimits. The day resets at 00:00 UTC. A request that is refused does not count against you. Need more? Ask your Pinnacle rep.

Knowing where you stand

Every successful response carries these headers for the kind of request you just made:

X-RateLimit-Limit: 50            X-RateLimit-Remaining: 37        (this minute)
X-RateLimit-Limit-Hour: 200      X-RateLimit-Remaining-Hour: 112
X-RateLimit-Limit-Day: 500       X-RateLimit-Remaining-Day: 391

When you go over

You get HTTP 429. The body says which limit you reached and how long to wait, and the Retry-After header carries the same wait in seconds. Wait that long, then send the request again.

{
  "error": "Rate limit exceeded: this key allows 50 quote requests per minute. Retry in 23 seconds.",
  "limit": {
    "group": "quotes",
    "window": "minute",
    "max": 50,
    "retryAfterSeconds": 23,
    "resetsAt": "2026-10-01T15:04:00.000Z"
  }
}
Tracking many shipments? Look up each shipment once per polling cycle, stop polling a shipment once it is delivered, and spread the lookups out rather than sending them all in the same second. Sixty lookups a minute covers a lot of freight when they are not all sent at once.

Common mistakes

Almost every support ticket we get is one of these five.

If you see thisIt usually means
401 Invalid API key The key was copied with a missing character or extra whitespace. Copy it again from where your rep sent it.
401 Missing X-API-KEY The header name is wrong. It is X-API-KEY, not Authorization or api-key.
403 not permitted Your key is fine, but that endpoint is not switched on for you. Ask your rep to enable it.
405 requires POST You used GET. Every endpoint is POST, including tracking and document lookups.
400 with a field name A required field is missing or the wrong type. Dates are 2026-01-31T00:00:00, dimensions are inches, weight is pounds.

Endpoints

Click any endpoint to open it. Each one has a fill-in form, a live test button, and a code generator. Verify your key above and the ones you can use will be marked.

Errors & fixes

StatusWhat it means and what to do
200Success.
400Something in your body is missing or invalid. The message names the field.
401Missing or unrecognized key. Check the header name and that you are posting to our base URL.
403Valid key, but that endpoint is not enabled for you. Contact your rep.
404No such endpoint. Check the path for a typo.
405Wrong HTTP method. Use POST.
429You reached a rate limit. The response says which one and how long to wait; the Retry-After header has the wait in seconds.
501That endpoint is not offered through this API at all.
502Temporary problem on our side or a carrier's. Retry; if it persists, contact us.

Accepted values

Freight class

Not sure? Use the suggested class endpoint.

50, 55, 60, 65, 70, 77.5, 85, 92.5, 100, 110, 125, 150, 175, 200, 250, 300, 400, 500

Packaging type

Bag, Bale, Box, Bucket, Bundle, Can, Carton, Case, Coil, Crate, Cylinder,
Drums, Pail, Pieces, Pallet, Reel, Roll, Skid, Tube, Tote

Reference / identifier types

PRO, BILL_OF_LADING, CUSTOMER_REFERENCE, PICKUP, PURCHASE_ORDER, EXTERNAL, SALES_ORDER

Document types

BillOfLading, DeliveryReceipt, WeightCertificate, Invoice, PackingVisualization,
SignedBillOfLading, CarrierBillOfLading, PalletLabel, RateConfirmation

Formats: PDF, TIF, PNG, GIF, JPG.

Truckload equipment

53_Foot_Dry_Van, Sprinter_Van, Straight_Truck, Large_Straight_Truck,
Small_Straight_Truck, 53_Foot_Flatbed, 48_Foot_Flatbed,
53_Foot_Step_Deck, 48_Foot_Step_Deck

Accessorial codes

Send each one as {"code": "LGDEL"} in accessorialServices. A code that is not on this list is answered with a 400 naming it, and nothing is quoted.

CodeAt pickup
AIRPUAirport pickup
CAMPPUCamp pickup
CHRCPUChurch pickup
CONPUConstruction site pickup
CFSPUContainer freight station pickup
CLUBPUCountry club pickup
DOCKPUDock pickup (will call)
FARMPUFarm pickup
GOVPUGovernment site pickup
GROPUGrocery warehouse pickup
HOSPUHospital pickup
HOTLPUHotel pickup
INPUInside pickup
LGPULiftgate pickup
LTDPULimited access pickup
MILPUMilitary base pickup
MINEPUMine site pickup
PIERPUPier pickup
PRISPUPrison pickup
RESPUResidential pickup
EDUPUSchool pickup
SORTPUSort and segregate pickup
CNVPUTrade show pickup
UTLPUUtility site pickup
CodeAt delivery
MANDEL22 man delivery (few carriers price it)
MANDEL33 man delivery (few carriers price it)
MANDEL44 man delivery (few carriers price it)
AIRDELAirport delivery
CAMPDELCamp delivery
CHRCDELChurch delivery
CONDELConstruction site delivery
CFSDELContainer freight station delivery
CLUBDELCountry club delivery
APPTDelivery appointment
FARMDELFarm delivery
FLTBDELFlatbed delivery (few carriers price it)
GOVDELGovernment site delivery
GRODELGrocery warehouse delivery
HOSDELHospital delivery
HOTLDELHotel delivery
INDELInside delivery
LGDELLiftgate delivery
LTDDELLimited access delivery
MILDELMilitary base delivery
MINEDELMine site delivery
NOTIFYNotify before delivery
PIERDELPier delivery
PRISDELPrison delivery
RESDELResidential delivery
RDNSResidential direct no signature (few carriers price it)
RDRCResidential direct room of choice service (few carriers price it)
RDTHResidential direct threshold (few carriers price it)
RDWGResidential direct white glove service (few carriers price it)
RDWG20Residential direct white glove service 20 min (few carriers price it)
RDWG30Residential direct white glove service 30 min (few carriers price it)
RDWG45Residential direct white glove service 45 min (few carriers price it)
RDWG60Residential direct white glove service 60 min (few carriers price it)
EDUDELSchool delivery
SORTDELSort and segregate delivery
CNVDELTrade show delivery
UTLDELUtility site delivery
WG30White glove assembly 30 mins (few carriers price it)
WG60White glove assembly 60 mins (few carriers price it)
CodeWhole shipment
GURGuaranteed by 5 PM
HAZMHazardous material
PFZProtect from freezing
*Miscellaneous charge

Excessive length: don't send a code for it. Give each item's real length in inches and the carrier's overlength charge is added to the price automatically from 72 in (6 ft) up. Not available through the API: Saturday pickup, blind shipment and delivery guaranteed by a set hour or window. Ask your Pinnacle rep to add them to the shipment. Codes marked few carriers price it are valid but return fewer carriers.

Get help

Stuck on something? Contact your Pinnacle Logistics account rep. It speeds things up a lot if you include the endpoint you called, the request body, and the full response you got back — the Copy result button on any test above grabs all of that for you.