# C.H. Robinson — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search available freight loads, get real-time load board statistics, and explore C.H. Robinson's logistics services across carriers and industries. Use location autocomplete to quickly find shipping origins and destinations while discovering the full range of freight and carrier services available through the platform.

**Category:** Marketplaces | **Website:** [chrobinson.com/](https://chrobinson.com/) | **Docs:** [parse.bot/marketplace/0453822d-84c4-4bf1-8ff4-7474173ff1d2/chrobinson-com-api](https://parse.bot/marketplace/0453822d-84c4-4bf1-8ff4-7474173ff1d2/chrobinson-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get carrier services

Retrieve information about carrier-facing services and financial programs offered by C.H. Robinson. Returns a static catalog including financial services, programs, technology solutions, and onboarding information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/get-carrier-services \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get freight services

Retrieve the list of freight services offered by C.H. Robinson. Returns a static catalog of service types with their relative URL paths.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/get-freight-services \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get industries

Retrieve the list of industry verticals served by C.H. Robinson. Returns a static catalog of industries with their relative URL paths.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/get-industries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get load board stats

Retrieve current load board statistics including total available loads and counts by equipment type (dry van, reefer, flatbed). Data is scraped from the load board landing page and reflects real-time availability.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/get-load-board-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get location autocomplete

Autocomplete city and postal code suggestions for origin and destination fields. Returns matching locations with coordinates, state/province codes, and country information. Use the returned coordinates as input to search_loads.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | City name or postal code prefix to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/get-location-autocomplete \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### Search loads

Search for available freight loads on the public load board. Returns a list of shipments with origin, destination, distance, weight, and equipment details. Requires origin coordinates and city/state. Optionally filter by destination, equipment type, and pickup dates. Destination coordinates must be provided in the request body only (not query params) to avoid upstream 500 errors.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `destination_city` | string | No | Destination city name |
| `destination_latitude` | number | No | Destination latitude |
| `destination_longitude` | number | No | Destination longitude |
| `destination_radius` | integer | No | Destination search radius in miles |
| `destination_state` | string | No | Destination US state code (two-letter, e.g. TX) |
| `equipment_type` | string | No | Trailer equipment type filter: Van, Flatbed, or Reefer |
| `mode` | string | No | Shipping mode. A for All. |
| `origin_city` | string | Yes | Origin city name |
| `origin_latitude` | number | Yes | Origin latitude |
| `origin_longitude` | number | Yes | Origin longitude |
| `origin_radius` | integer | No | Origin search radius in miles |
| `origin_state` | string | Yes | Origin US state code (two-letter, e.g. IL) |
| `page_size` | integer | No | Number of results per page |
| `pickup_end` | string | No | Pickup date range end in YYYY-MM-DD format. Defaults to tomorrow (UTC). |
| `pickup_start` | string | No | Pickup date range start in YYYY-MM-DD format. Defaults to today (UTC). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/c-h-robinson/search-loads \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"destination_city":"<string>","destination_latitude":"<number>","destination_longitude":"<number>","destination_radius":"<integer>","destination_state":"<string>","equipment_type":"<string>","mode":"<string>","origin_city":"<string>","origin_latitude":"<number>","origin_longitude":"<number>","origin_radius":"<integer>","origin_state":"<string>","page_size":"<integer>","pickup_end":"<string>","pickup_start":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.