Yard Management Systems: Container OCR API

The Chaos of Yard Inventory Management

A Yard Management System (YMS) relies on perfect location tracking, but maintaining accuracy in a dynamic stacking yard is incredibly difficult. When reach stackers, empty handlers, and RTGs move containers, manual spotters or basic optical character recognition systems often misread IDs due to harsh sunlight, deep shadows between stacks, and skewed camera angles. This leads to "lost" containers and massive operational delays. To see how our engine cuts through these extreme visual challenges, you can upload a test image to explore our core Container OCR capabilities completely free.

A Universal API Engineered for the Yard

Delivered strictly as a lightweight REST API to ensure seamless integration into your YMS architecture without the bloat and dependency conflicts of traditional SDKs, this endpoint is powered by our Logistics Container OCR engine. It excels in complex, multi-layered visual environments. The engine applies strict ISO 6346 validation on the fly, instantly calculating check digits to guarantee that only perfectly accurate Container Codes update your digital yard map.

Yard Management Workflows

Integration & AI Prompts

Call the endpoint directly via HTTP from your YMS middleware or mobile yard devices. To maintain maximum security within port networks, the API flexibly accepts direct multipart file uploads or Base64-encoded strings, avoiding the need to expose local operations via public URLs.

import requests
import base64

# Prepare Base64 Image from reach stacker cabin camera
with open("yms_reach_stacker_cam.jpg", "rb") as image_file:
    base64_image = base64.b64encode(image_file.read()).decode('utf-8')

url = "https://api.structocr.com/v1/container"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "img": base64_image
}

try:
    print("Scanning Yard Capture...")
    response = requests.post(url, headers=headers, json=payload)
    result = response.json()

    if result.get('success'):
        data = result['data']
        print("✅ Container Code Extracted!")
        print(f"Full Number:  {data.get('container_number')}")
        print(f"Valid ISO:    {data.get('is_valid')}")
        print(f"Confidence:   {data.get('confidence')}")
    else:
        print(f"❌ Extraction Failed: {result.get('error')} - {result.get('message')}")

except Exception as e:
    print(f"An error occurred: {e}")

{
  "success": true,
  "data": {
    "container_number": "ZCSU8921655",
    "is_valid": true,
    "confidence": "High",
    "parsed": {
      "owner_code": "ZCS",
      "category": "U",
      "serial_number": "892165",
      "check_digit": "5"
    }
  }
}