# Cargado API Docs

- [Overview](https://docs.cargado.com/guides/overview.md): Integrate with Cargado using APIs
- [Sandbox](https://docs.cargado.com/guides/sandbox.md)
- [Sync loads from your TMS](https://docs.cargado.com/guides/load-sync/load-sync.md)
- [Test your load sync](https://docs.cargado.com/guides/load-sync/test-sync.md)
- [Send rate confirmations](https://docs.cargado.com/guides/load-sync/send-rate-con.md)
- [Look up the rate for freight](https://docs.cargado.com/guides/rates/rate-lookup.md)
- [Manage carrier relationships](https://docs.cargado.com/guides/carrier-relationships/manage-carrier-relationships.md)
- [Webhooks](https://docs.cargado.com/guides/webhooks.md): Receive real-time event notifications from Cargado
- [Overview](https://docs.cargado.com/api-reference/concepts/overview.md): The official Cargado API documentation
- [Authorization and Testing](https://docs.cargado.com/api-reference/concepts/auth-and-testing.md)
- [Versioning](https://docs.cargado.com/api-reference/concepts/versioning.md)
- [OpenAPI](https://docs.cargado.com/api-reference/concepts/openapi.md)
- [Requests and Responses](https://docs.cargado.com/api-reference/concepts/requests-and-responses.md)
- [Identifiers](https://docs.cargado.com/api-reference/concepts/identifiers.md)
- [Pagination](https://docs.cargado.com/api-reference/concepts/pagination.md)
- [Errors](https://docs.cargado.com/api-reference/concepts/errors.md)
- [Metadata](https://docs.cargado.com/api-reference/concepts/metadata.md)
- [Load object](https://docs.cargado.com/api-reference/models/load.md)
- [Sync a load](https://docs.cargado.com/api-reference/loads/sync-a-load.md): Sync a load from your TMS to Cargado, creating or updating any load details and status.
- [RateHistoryLookup object](https://docs.cargado.com/api-reference/models/rateHistoryLookup.md)
- [Lookup rate history](https://docs.cargado.com/api-reference/rates/lookup-rate-history.md): Look up the rate history for a lane. This is considered a mutation because it is a metered operation and calls are recorded for possible billing purposes.
- [Get border crossing recommendations](https://docs.cargado.com/api-reference/border-crossings/get-border-crossing-recommendations.md): Get recommended US-Mexico border crossings for one or more routes. Returns recommended crossings filtered by confidence threshold, in the same order as the input requests. Routes that do not cross the US-Mexico border will return an error result.
- [CarrierRelationship object](https://docs.cargado.com/api-reference/models/CarrierRelationship.md)
- [Upsert carrier relationships](https://docs.cargado.com/api-reference/carrierrelationship/upsert-carrier-relationships.md): Create or update carrier relationships and statuses from your TMS to Cargado. If a carrier is not found, the relationship will be null. Returns the relationships in the same order and length as the input.
- [Update a bid](https://docs.cargado.com/api-reference/bids/update-a-bid.md): Patch a Bid. Omitted fields are left unchanged; sending null explicitly clears the field. Currently only `externalId` is patchable. Returns the updated bid.
- [Update users by email](https://docs.cargado.com/api-reference/user/update-users-by-email.md): Update user external IDs by email. Matches users in your organization by email and assigns each an externalId for use in subsequent API calls (e.g., load sync coverage assignment).
- [Update teams by email](https://docs.cargado.com/api-reference/team/update-teams-by-email.md): Update team external IDs by email. Matches teams in your organization by email and assigns each an externalId for use in subsequent API calls (e.g., load sync coverage assignment).
- [Register webhook endpoint](https://docs.cargado.com/api-reference/webhooks/register-webhook-endpoint.md): Create a webhook endpoint for your organization. Cargado will POST event payloads to the given URL, signed with the returned secret so you can verify authenticity. The signing secret is only included in this response — store it securely.
- [List webhook endpoints](https://docs.cargado.com/api-reference/webhooks/list-webhook-endpoints.md): Return webhook endpoints registered for your organization, with cursor-based pagination.
- [Get webhook endpoint](https://docs.cargado.com/api-reference/webhooks/get-webhook-endpoint.md): Retrieve details for a single webhook endpoint.
- [Update webhook endpoint](https://docs.cargado.com/api-reference/webhooks/update-webhook-endpoint.md): Patch a webhook endpoint. Only the fields you include in the body are changed — everything else stays as-is.
- [Delete webhook endpoint](https://docs.cargado.com/api-reference/webhooks/delete-webhook-endpoint.md): Permanently remove a webhook endpoint. In-flight deliveries may still complete, but no new events will be sent to this URL.
- [Rotate endpoint secret](https://docs.cargado.com/api-reference/webhooks/rotate-endpoint-secret.md): Rotate the signing secret for a webhook endpoint. The old secret stays valid for 24 hours so you can update your verification code without dropping events.
- [Test webhook endpoint](https://docs.cargado.com/api-reference/webhooks/test-webhook-endpoint.md): Send a test event to a webhook endpoint to verify connectivity. Check your server logs to confirm the signed payload arrived.
- [Event Types](https://docs.cargado.com/api-reference/events/index.md): The webhook events Cargado publishes and the payloads they carry
- [WebhookEvent object](https://docs.cargado.com/api-reference/models/WebhookEvent.md)
- [Bid events](https://docs.cargado.com/api-reference/bid-events.md): Delivered for every bid event. The `type` field identifies which one:

## OpenAPI Specs

- [openapi](/openapi.yml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.