BIC-BoxTech API

Name: BIC-BoxTech API API
Brand: BIC-BoxTech API
Availability: InStock

✓ Official Vendor SpecE CommerceShipping Logisticsbearer, basic12 EndpointsREST

For Agents

Look up shipping container technical details, verify BIC code ownership, and upload fleet data via the BIC Global Container Database.

Quickstart

Get started with BIC-BoxTech API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"look up a container by number"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with BIC-BoxTech API API.

Look up the technical details for a specific container number

Verify the holder of a BIC owner code for ownership confirmation

Retrieve a container's tare weight and maximum gross mass in kilograms

Resolve an ISO 6346 size-type code to its container specification

Upload fleet data on behalf of a container operator

GET STARTED

Start building with BIC-BoxTech API API

Explore with Jentic

View OpenAPI Document

Use for: I need to look up the technical details for container MSCU1234567, Verify the holder of BIC code MSCU, Get the tare weight in kilograms for a specific container, Resolve ISO size-type code 22G1 to its specification

Not supported: Does not handle parcel tracking, customs clearance, or freight quoting — use for intermodal container identity and technical detail lookup only.

BIC-BoxTech is the API for the Bureau International des Containers (BIC) Global Container Database, the authoritative registry of intermodal shipping containers. It exposes container technical details (dimensions, tare weight, maximum gross mass, ISO size-type code), BIC code holder lookups for owner identification, fleet upload for container operators, and alerting on container number changes. Authentication uses an OAuth2-style bearer token obtained from /oauth/token, with HTTP Basic supported as a secondary scheme. Both production (app.bic-boxtech.org) and UAT (uat.bic-boxtech.org) hosts are exposed.

Use Cases

Patterns agents use BIC-BoxTech API API for, with concrete tasks.

★ Container Specification Lookup

Resolve a container number to its full technical specification at receipt or dispatch. GET /container/{containerNumber} returns the container record including ISO size-type code, tare weight, and maximum gross mass. Operators use this to verify physical handling characteristics before loading and to confirm ownership when accepting containers from other carriers.

Call /container/MSCU1234567 and return tare weight, max gross mass, and ISO size-type code.

BIC Code Ownership Verification

Confirm the owner of a BIC code (the four-letter prefix on every intermodal container) before accepting a container into a yard or onto a vessel. GET /codes/{bicCode} returns the registered holder, which protects against fraudulent or expired codes. Combined with the container details endpoint this gives a complete identity check.

Call /codes/MSCU and return the registered holder name and contact details.

Fleet Data Upload for Container Operators

Submit fleet inventory updates on behalf of a container operator so the global database reflects newly registered or reassigned containers. POST /container accepts the upload payload, and GET /uploads/{uploadId} returns the processing status. This is required for operators that want their fleet visible to global counterparties.

Upload a CSV of 500 new containers via POST /container and poll GET /uploads/{uploadId} until processing completes.

AI Agent Container Intake Assistant

An AI agent helping a port operator intake containers can verify ownership and pull technical specifications in a single workflow. Through Jentic the agent searches for 'verify container BIC code' and 'get container details', loads each schema, and executes — Jentic injects the bearer token so the agent never handles raw operator credentials.

Search Jentic for 'look up a container by number', execute /container/MSCU1234567, and confirm the holder via /codes/MSCU.

Key Endpoints

12 endpoints — bic-boxtech is the api for the bureau international des containers (bic) global container database, the authoritative registry of intermodal shipping containers.

METHOD

PATH

DESCRIPTION

POST

/oauth/token

Obtain an access token

GET

/codes/{bicCode}

Look up a BIC code holder

POST

/container

Upload container fleet data

GET

/container/{containerNumber}

Get container technical details

GET

/tare_kg/{containerNumber}

Get tare weight in kilograms

GET

/iso/size_type_code/{sizeTypeCode}

Look up an ISO size-type code

POST

/oauth/token

Obtain an access token

GET

/codes/{bicCode}

Look up a BIC code holder

POST

/container

Upload container fleet data

GET

/container/{containerNumber}

Get container technical details

GET

/tare_kg/{containerNumber}

Get tare weight in kilograms

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

BIC-BoxTech bearer tokens (and optional basic-auth credentials) are stored encrypted in the Jentic vault (MAXsystem). Agents call BIC-BoxTech operations via Jentic and the Authorization header is injected at execution time — raw operator credentials never enter the agent's context.

Intent-based discovery

Agents search by intent (e.g., 'look up a container by number') and Jentic returns the matching BIC-BoxTech operation with its parameters, so the agent does not need to know which of the 12 endpoints exposes the technical detail it wants.

Time to first call

Direct BIC-BoxTech integration: 1-2 days for OAuth, environment routing between UAT and production, and CSV upload handling. Through Jentic: under 30 minutes — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

AfterShip API

AfterShip tracks parcel and container movements after their identity has been verified via BIC-BoxTech.

Use BIC-BoxTech to verify the container identity, then AfterShip to track its movements end-to-end.

Complementary

Shippo API

Shippo handles parcel-level shipping labels for last-mile movement around containerised freight.

Pair when an agent ships goods from a container to end customers; BIC-BoxTech for the container, Shippo for the parcel.

Alternative

FedEx API

FedEx tracks shipments at the parcel and freight level; BIC-BoxTech focuses on container identity rather than transit.

Choose FedEx for parcel and freight tracking; choose BIC-BoxTech for intermodal container specification and ownership lookup.

FAQs

Specific to using BIC-BoxTech API API through Jentic.

What authentication does the BIC-BoxTech API use?

BIC-BoxTech supports two schemes: HTTP Bearer (the recommended scheme — obtain the access token from POST /oauth/token) and HTTP Basic. Through Jentic, the bearer token is stored encrypted in the Jentic vault (MAXsystem) and injected at execution time so the agent never sees the raw token.

Can I look up a container by its container number?

Yes. GET /container/{containerNumber} returns the technical record including tare weight, maximum gross mass, and ISO 6346 size-type code. You can also use GET /tare_kg/{containerNumber} or GET /max_gross_mass_kgs/{containerNumber} to fetch specific properties without loading the full record.

How do I verify a BIC owner code?

Call GET /codes/{bicCode} with the four-letter BIC prefix. The response includes the registered holder details, which lets you confirm the container's ownership before accepting it into your yard or onto a vessel.

How do I upload fleet data through Jentic?

Search Jentic for 'upload container fleet', load POST /container, and execute with the upload payload. Then poll GET /uploads/{uploadId} until processing completes. With the SDK: pip install jentic, then SearchRequest, LoadRequest, ExecutionRequest in an async flow.

Is there a sandbox environment for the BIC-BoxTech API?

Yes — the spec exposes a UAT host at https://uat.bic-boxtech.org/api/v2.0 alongside production at https://app.bic-boxtech.org/api/v2.0. Use UAT for integration testing before promoting to production credentials.