Transport Code Types
The Transportation & Cargo API reads transport identifiers through
POST /transport/{type}. The type path parameter selects which family of
codes the engine should search for.
Supported Types
| Type | Purpose | Typical identifiers |
|---|---|---|
iso | ISO container and intermodal loading unit recognition. | BIC/ISO 6346 owner code, serial number, check digit, optional ISO equipment/type code. |
truck | Truck and road transport identifiers. | ACCR, US DOT, chassis and similar road vehicle fleet identifiers. |
eu-rail | European railway vehicle identifiers. | Wagon and locomotive identifiers used across Europe. |
am-rail | American railway vehicle identifiers. | Wagon and locomotive identifiers used on the American continent. |
Validation Behavior
Many transport identifiers contain a checksum. By default, the API verifies
that checksum and discards results where validation fails. Send
x-disable-checksum-check: true when you need to inspect low-confidence or
checksum-invalid reads.
Type-specific Headers
| Header | Applies to | Effect |
|---|---|---|
x-disable-iso-code | iso | Disables searching for and reading the last four digits of the ISO container equipment/type code. |
x-enable-full-us-accr-code | truck / accr_usa engine mode | Enables full US ACCR code recognition where supported by the engine configuration. |
Request Example
curl -X POST "https://api.carmencloud.com/transport/iso" \
-H "x-api-key: $CARMEN_API_KEY" \
-F "image=@container.jpg" \
-F "maxreads=1"
Response Shape
Transport responses contain a data.codes array. Each item represents one
merged code result and can include per-image details under imageResults.
{
"version": "1.0.1",
"data": {
"codes": [
{
"code": "MSCU1234567",
"confidence": 96,
"imageResults": []
}
]
}
}