canonical: https://jentic.com/apis/bluecargo.io/bluecargo

# BlueCargo

The BlueCargo API manages container logistics around bookings, shipments, and carriers. It creates and lists container bookings, registers shipments and lists them, and looks up a shipment by its bill of lading to read its current state. Carriers can be listed and read by name, so an integration can place a booking with the right carrier and follow the container through to arrival.

## For AI agents

Manage container logistics with BlueCargo: create and list bookings, register shipments, look up a shipment by its bill of lading, and list carriers across 7 endpoints.

## Scope

Does not handle customs clearance, freight payments, or warehouse inventory. Use for container bookings, shipments, and carrier lookups only.

## Capabilities

- Create container bookings and list the ones you have placed
- Look up a shipment by its bill of lading
- List the carriers you can book with and read one by name
- Register a new shipment for tracking
- List your shipments and check their state

## Use cases

### Automate container booking through Jentic

Let an agent place container bookings without hand-wiring the API. The agent creates a booking with the chosen carrier and lists existing bookings to confirm it. Through Jentic the booking operation is discovered by intent and called with its input schema, so a booking is placed in one step.

Example prompt: Create a booking with POST /bookings, then confirm it with GET /bookings

### Shipment status by bill of lading

Track a container by the one identifier everyone shares: its bill of lading. The agent passes the bill of lading to the shipment lookup and reads the shipment's current state, so a logistics workflow can report arrival status without manual portal checks.

Example prompt: Look up a shipment with GET `/shipments/{bill_of_lading}`

### Carrier lookup

Pick the right carrier before placing a booking. The agent lists the carriers available to it and reads one by name to confirm details, so bookings are placed against a valid carrier.

Example prompt: List carriers with GET /carriers, then read one with GET `/carriers/{name}`

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/bookings` | Create a container booking |
| GET | `/bookings` | List bookings |
| POST | `/shipments` | Create a shipment |
| GET | `/shipments/{bill_of_lading}` | Look up a shipment by bill of lading |
| GET | `/carriers` | List carriers |
| GET | `/carriers/{name}` | Read a carrier by name |

## Key resources

- **Bookings** — Create and list container bookings
- **Shipments** — Create shipments and look them up by bill of lading
- **Carriers** — List carriers and read one by name

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 57 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 37 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 50 / 100
- **View full report:** https://jentic.com/apis/bluecargo.io/bluecargo/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring BlueCargo by hand means learning its `X-Api-Key` header auth and its booking, shipment, and carrier shapes keyed by bill of lading. Through Jentic you install once, import BlueCargo from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** BlueCargo puts the bill of lading in the URL path (`/shipments/{bill_of_lading}`), so a rule can bound your agent to reading specific shipments. You choose which operations it may call, so creating bookings or shipments stays out unless you add them, letting a read-only agent track freight without placing orders.
- **Credential handling:** Your BlueCargo key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up a shipment by bill of lading' or 'create a container booking', and Jentic returns the matching BlueCargo operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **DAT Freight API** — DAT is a trucking freight marketplace and rate data source; BlueCargo focuses on ocean container bookings and shipment tracking.
- **AfterShip Shipping API** — AfterShip tracks parcels across hundreds of carriers; BlueCargo handles the container booking and ocean shipment leg.
- **Octopi API** — Octopi is a terminal operating system for marine terminals; BlueCargo is the shipper-side booking and tracking view.

## FAQ

### What authentication does the BlueCargo API use?

The BlueCargo API authenticates with an API key sent in the `X-Api-Key` header per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time.

### Can I track a shipment by its bill of lading with the BlueCargo API?

Yes. Pass a bill of lading to the shipment lookup and BlueCargo returns that shipment and its current state. You can also list all your shipments or register a new one for tracking.

### Can I limit what my agent is allowed to do with the BlueCargo API?

Yes. Write a rule that allows only the shipment and carrier read operations, so your agent can track freight and look up carriers but cannot create bookings or shipments unless you add those operations. BlueCargo carries the bill of lading in the URL path, so reads can be bound to a specific shipment.

### What are the rate limits for the BlueCargo API?

The OpenAPI spec does not specify rate limits. Check the BlueCargo documentation at https://bluecargo.io for current limits before polling shipment status frequently.

### Is there a BlueCargo MCP server?

You don't need an MCP server to give your agent BlueCargo. Jentic connects it directly from the API Directory: import it, store your key once, and your agent runs the booking, shipment, and carrier operations on demand. That also keeps extra tool definitions out of the agent's context.

### How do I look up a shipment by bill of lading with the BlueCargo API through Jentic?

Search Jentic for 'look up a shipment by bill of lading' and it returns the BlueCargo shipment operation with its input schema. Your agent passes the bill of lading and reads back the shipment and its state. To run it on your own infrastructure, install Jentic One from its GitHub repo.