Works with McLeod, Turvo, Tai and Revenova, or any TMS through our API.
Load fields unchanged by Cargado
Example carriers, loads and rates.
“Cargado Market Rates helps us quote fast, and that’s when you win it. Customers ask for a rate at 11, and by 11:30 they have it.”
Patty HinojosaVP of Mexico Sales and Operations
=CARGADO.RATE_HISTORY_P50(A2, B2, C2, D2)
Filter loads in the integration layer before they reach Cargado, or filter them in Cargado.
A synced load stays private until your posting rules or your reps put it on the board.
Anything never posted or shared is deleted when you ask.
Included with your Cargado subscription.
A 30-minute call on your TMS, lanes and how reps post today.
Ops + ITTakes minutes. On Revenova, under 30 minutes for your Salesforce admin.
IT, onceStatuses, trailer types, coverage owners and posting rules, tested in a sandbox. About a week, depending on how fast your team answers.
OpsStart with your Mexico or Canada lanes. Add more later.
Ops turns it onOn the public API? Your engineers build your side against our sandbox and docs.
POST /bids/update.Every connection fills the same Cargado load model. We map your McLeod fields to it during setup.
Field names from the load sync API. Money is in the smallest currency unit, so $4,125.00 is 412500.
| On your load | Cargado field | Notes |
|---|---|---|
| Synced to Cargado | ||
| Origin and destination | stops[] | PICKUP first, DELIVERY last, with each stop’s time zone. Up to 64 stops. |
| Border crossing | borderCrossings[] | For example LAREDO_INTL_BRIDGE. If your TMS has none, the matching lane fills it in. |
| Equipment | trailerRequirements | For example DRY_VAN_53 or REEFER. |
| Pickup and delivery windows | stops[].appointment | A window, an exact time, first come first served, or to be set. |
| Reference numbers | referenceNumbers[] | PO #, BOL # or PRO #, on the load and on each stop. |
| Rate | targetRate, maxBuy | Guides your team and can drive posting rules. |
| Load and customer IDs | externalId, externalCustomerId | Never shown outside your organization. |
| Status | status | ON_HOLD AVAILABLE ASSIGNED BOOKED CANCELLED COMPLETED |
| Back from Cargado | ||
| Bid amount | bid.rateDetails | A total plus line items: all-in, or the Mexico leg, crossing fee and U.S. leg. |
| Carrier | carrier | Name, DOT, MC, RFC, CVOR, NIR, NSC, SCAC, contact, and your TMS’s carrier ID. |
| Bid status | bid.status | ACCEPTED, REJECTED, COUNTERED and others. |
McLeod: equipment types, status codes and deduct codes are matched once, during setup. Charge codes such as DET carry over on the carrier’s price.
Turvo: each charge line keeps its Turvo line item ID, so prices reconcile line by line.
DO_NOT_DISPATCHNever sees your freight and can’t be assigned to it.NEEDS_REVIEWReviewed by your team before being assigned.ACTIVECan be assigned the moment a load posts.NEEDS_TO_ONBOARDGets an onboarding link on its first match.The posting comes down when you accept a bid on Cargado, the load is assigned, booked or canceled in your TMS, or it is no longer eligible (for example LTL).
Running your own TMS?
| Production | https://api.cargado.com |
| Sandbox | https://api.sandbox.cargado.com, with a broker and a carrier test organization. No real freight posts. |
| Authentication | An Api-Key header, one key for production and one for the sandbox. |
| Webhooks | Signed to the Standard Webhooks spec. After a secret rotation, the old secret works for 24 hours. |
POST /loads/sync | Create or update a load and its status. |
POST /carrier-relationships/upsert | Carrier statuses from your TMS, including do not use. |
POST /rates/history | Market Rates for up to 64 lanes per request. Metered. |
POST /bids/update | Store your TMS offer ID on a bid. |
POST /webhooks/endpoint/register | Register an endpoint for bid events. |
externalId existsPOST https://api.cargado.com/loads/sync Api-Key: <API Key> Content-Type: application/json { "load": { "externalId": "TMS232423", "externalCustomerId": "CUST-1042", "status": "AVAILABLE", "referenceNumbers": [{ "label": "PO #", "value": "45-88120" }], "commodities": [{ "name": "Auto parts", "weight": { "type": "APPROXIMATE", "value": 42000, "unit": "POUNDS" }, "hazmatDetails": { "isHazmat": false } }], "trailerRequirements": { "allowedTypes": ["DRY_VAN_53"] }, "carrierRequirements": { "ctpatCertified": true }, "driverRequirements": {}, "targetRate": { "currencyCode": "USD", "amount": 412500 }, "stops": [ { "type": "PICKUP", "externalId": "STOP-1", "location": { "place": { "type": "ADDRESS", "city": "Monterrey", "state": "NLE", "countryCode": "MX" }, "timezone": "America/Monterrey" }, "appointment": { "type": "SET_APPOINTMENT_WINDOW", "windowStartTime": "2026-10-05T08:00:00", "windowEndTime": "2026-10-05T14:00:00" } }, { "type": "DELIVERY", "externalId": "STOP-2", "location": { "place": { "type": "ADDRESS", "city": "Chattanooga", "state": "TN", "countryCode": "US" }, "timezone": "America/New_York" }, "appointment": { "type": "SET_APPOINTMENT_WINDOW", "windowStartTime": "2026-10-08T06:00:00", "windowEndTime": "2026-10-08T14:00:00" } } ], "borderCrossings": [ { "type": "BORDER_CROSSING", "externalId": "XING-1", "usMxBorderCrossing": "LAREDO_INTL_BRIDGE" } ] } }
{
"load": {
"id": "load_6e4cf1d1-b776-4401-a326-e43df6107e17",
"externalId": "TMS232423",
"externalCustomerId": "CUST-1042",
"status": "AVAILABLE",
"trailerRequirements": { "allowedTypes": ["DRY_VAN_53"] },
"stops": [ /* pickup, delivery */ ]
}
}
// Synced loads do not post on their own.
// A load posts when it matches a posting
// rule you set in Cargado.
//
// Takedown: send status BOOKED or
// CANCELLED, or set assignedCarrier.
// Sending assignedCarrier: null cancels
// the booking in Cargado.POST https://api.cargado.com/rates/history Api-Key: <API Key> Content-Type: application/json { "requests": [ { "stops": [ { "type": "PICKUP", "placeDetails": { "place": { "type": "CITY", "city": "Monterrey", "state": "MX_NLE", "country": "MX" } } }, { "type": "BORDER_CROSSING", "usMxBorderCrossing": "LAREDO_INTL_BRIDGE" }, { "type": "DELIVERY", "placeDetails": { "place": { "type": "CITY", "city": "Chicago", "state": "US_IL", "country": "US" } } } ], "trailerRequirements": { "allowedTypes": ["DRY_VAN"] } } ] }
{
"results": [
{
"type": "DATA",
"id": "rhl_9bb338d8-dd63-4441-95b5-ef7e9d890bb2",
"rateHistory": {
"pricingLane": {
"trailerCategory": "DRY_VAN",
"usMxBorderCrossing": "LAREDO_INTL_BRIDGE"
},
"currencyCode": "USD",
"suggestedRates": [
{
"dayRange": { "start": "2025-06-24", "end": "2025-06-30" },
"amountDistribution": {
"p25": 364321, // Low
"p50": 386075, // Mid
"p75": 409126 // High
},
"marginOfError": 7004,
"relativeMarginOfError": 0.02,
"confidenceScore": 94,
"confidence": "STRONG"
}
/* one entry per week, up to 12 weeks */
],
"routeMiles": 1513.56
}
}
]
}STRONG, MEDIUM or LOWER. Leave out the crossing and Cargado picks the recommended one.POST https://api.cargado.com/carrier-relationships/upsert Api-Key: <API Key> Content-Type: application/json { "carrierRelationships": [ { "carrier": { "dotNumber": "1234567", "mcNumber": "2342342" }, "status": "ACTIVE", "onboardingStatus": "ONBOARDED" }, { "carrier": { "rfcNumber": "012345678912" }, "status": "DO_NOT_DISPATCH", "onboardingStatus": "ONBOARDED" } ] }
// Returns the relationships in the same
// order and length as the input.
// If a carrier is not found, its
// relationship comes back as null.
//
// status: ACTIVE | NEEDS_REVIEW
// | DO_NOT_DISPATCH
// onboardingStatus: ONBOARDED
// | NEEDS_TO_ONBOARD
//
// Optional: carrierExternalId, your ID
// for the carrier in your TMS.POST https://your-endpoint.example.com/cargado webhook-id: <delivery id> webhook-timestamp: <timestamp> webhook-signature: <signature> { "eventId": "…", "actorId": "usr_…", "type": "bid.accepted", "timestamp": "…", "data": { "bid": { "id": "bid_…", "status": "ACCEPTED", "externalId": null, "rateDetails": { "type": "ItemizedBid", "totalAmount": { "currencyCode": "USD", "amount": 420000 }, "lineItems": [ /* AllIn, CountryLeg, BorderCrossing */ ] } }, "posting": { "id": "post_…", "targetRate": …, "maxBuy": …, "reservePrice": … }, "freight": { "externalId": "TMS232423", … }, "carrier": { "displayName": "Los Fletes Hermanos", "dotNumber": "…", "mcNumber": "…", "rfcNumber": "…", "externalId": "…" } } }
// Verify the signature against the RAW
// body before parsing. Reject timestamps
// outside a few minutes.
//
// Dedupe on eventId: a retry can deliver
// the same event twice.
//
// Other types: bid.submitted, bid.rejected,
// bid.revoked, bid.closed, bid.countered,
// bid.counter_accepted,
// bid.counter_revoked,
// bid.counter_rejected