Pinnacle Logistics API
Powered by
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.
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.
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.
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
- Method: always
POST, even for lookups. - Headers:
Content-Type: application/jsonandX-API-KEY: your key. - Body: JSON.
- Response: JSON, with HTTP
200on success.
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 request | Per minute | Per hour | Per day |
|---|---|---|---|
| Quotes LTL rates, TL rates, suggested class | 50 | 200 | 500 |
| Booking and changes book, cancel, add a reference, import | 5 | 30 | 100 |
| Tracking and documents shipment status, BOL / POD / invoice images, invoices | 60 | 300 | 5,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: 391When 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"
}
}Common mistakes
Almost every support ticket we get is one of these five.
| If you see this | It 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
| Status | What it means and what to do |
|---|---|
| 200 | Success. |
| 400 | Something in your body is missing or invalid. The message names the field. |
| 401 | Missing or unrecognized key. Check the header name and that you are posting to our base URL. |
| 403 | Valid key, but that endpoint is not enabled for you. Contact your rep. |
| 404 | No such endpoint. Check the path for a typo. |
| 405 | Wrong HTTP method. Use POST. |
| 429 | You reached a rate limit. The response says which one and how long to wait; the Retry-After header has the wait in seconds. |
| 501 | That endpoint is not offered through this API at all. |
| 502 | Temporary 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.
| Code | At pickup |
|---|---|
AIRPU | Airport pickup |
CAMPPU | Camp pickup |
CHRCPU | Church pickup |
CONPU | Construction site pickup |
CFSPU | Container freight station pickup |
CLUBPU | Country club pickup |
DOCKPU | Dock pickup (will call) |
FARMPU | Farm pickup |
GOVPU | Government site pickup |
GROPU | Grocery warehouse pickup |
HOSPU | Hospital pickup |
HOTLPU | Hotel pickup |
INPU | Inside pickup |
LGPU | Liftgate pickup |
LTDPU | Limited access pickup |
MILPU | Military base pickup |
MINEPU | Mine site pickup |
PIERPU | Pier pickup |
PRISPU | Prison pickup |
RESPU | Residential pickup |
EDUPU | School pickup |
SORTPU | Sort and segregate pickup |
CNVPU | Trade show pickup |
UTLPU | Utility site pickup |
| Code | At delivery |
|---|---|
MANDEL2 | 2 man delivery (few carriers price it) |
MANDEL3 | 3 man delivery (few carriers price it) |
MANDEL4 | 4 man delivery (few carriers price it) |
AIRDEL | Airport delivery |
CAMPDEL | Camp delivery |
CHRCDEL | Church delivery |
CONDEL | Construction site delivery |
CFSDEL | Container freight station delivery |
CLUBDEL | Country club delivery |
APPT | Delivery appointment |
FARMDEL | Farm delivery |
FLTBDEL | Flatbed delivery (few carriers price it) |
GOVDEL | Government site delivery |
GRODEL | Grocery warehouse delivery |
HOSDEL | Hospital delivery |
HOTLDEL | Hotel delivery |
INDEL | Inside delivery |
LGDEL | Liftgate delivery |
LTDDEL | Limited access delivery |
MILDEL | Military base delivery |
MINEDEL | Mine site delivery |
NOTIFY | Notify before delivery |
PIERDEL | Pier delivery |
PRISDEL | Prison delivery |
RESDEL | Residential delivery |
RDNS | Residential direct no signature (few carriers price it) |
RDRC | Residential direct room of choice service (few carriers price it) |
RDTH | Residential direct threshold (few carriers price it) |
RDWG | Residential direct white glove service (few carriers price it) |
RDWG20 | Residential direct white glove service 20 min (few carriers price it) |
RDWG30 | Residential direct white glove service 30 min (few carriers price it) |
RDWG45 | Residential direct white glove service 45 min (few carriers price it) |
RDWG60 | Residential direct white glove service 60 min (few carriers price it) |
EDUDEL | School delivery |
SORTDEL | Sort and segregate delivery |
CNVDEL | Trade show delivery |
UTLDEL | Utility site delivery |
WG30 | White glove assembly 30 mins (few carriers price it) |
WG60 | White glove assembly 60 mins (few carriers price it) |
| Code | Whole shipment |
|---|---|
GUR | Guaranteed by 5 PM |
HAZM | Hazardous material |
PFZ | Protect 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.