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

Checksum checks are handled internally by OCR engines from 7.3.20.46 and cannot be configured. The legacy X-Disable-Checksum-Check header is deprecated and has no effect on the returned result with these engines. It remains available for compatibility with older engines.

Type-specific Headers

Header	Applies to	Behavior
X-Disable-Additional-Code	iso, eu-rail	Disable Additional Code (optional): Setting true disables additional code reading for iso and eu-rail, such as the ISO equipment/type code. Supported by OCR engines from 7.3.20.46. If present, this header takes precedence over X-Disable-Iso-Code, including when its value is false. Other engine types ignore it. When omitted, the deprecated ISO header is used as a fallback; if neither header is set, additional code reading is enabled.
X-Disable-Iso-Code	iso, eu-rail	Deprecated — Disable ISO Code (optional): Use X-Disable-Additional-Code instead. The legacy header remains accepted for iso and eu-rail. On OCR engines from 7.3.20.46, it is a fallback only when the new header is omitted. An explicit false value of the new header also takes precedence.
X-Disable-Checksum-Check	Older OCR engines	Deprecated — Disable Checksum Check (optional): Retained for compatibility with older OCR engines. From 7.3.20.46, checksum checks are handled internally by the engine and cannot be configured. This header has no effect on the returned result.
X-Enable-Full-Us-Accr-Code	truck	Enable Full US ACCR Code (optional): Enables full US ACCR code recognition. NOTE: This parameter applies only to the TRUCK engine (truck code type, or legacy accr_usa); other engines ignore it.

Request Example

curl -X POST "https://api.carmencloud.com/transport/iso" \
  -H "x-api-key: $CARMEN_API_KEY" \
  -H "X-Disable-Additional-Code: true" \
  -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": []
      }
    ]
  }
}