Container OCR API for Saudi Arabia Supply Chains

Automating Logistics for Vision 2030

As Saudi Arabia rapidly expands its logistics infrastructure—from the massive Jeddah Islamic Port to the futuristic developments of NEOM—there is a massive push to eliminate manual inefficiencies. However, deploying automated scanning systems across vast desert landscapes presents severe challenges. Standard OCR algorithms fail when cameras are blinded by intense sunlight, or when container text is covered by airborne sand and dust. Local integrators need a robust, low-overhead API. For a deeper dive into overcoming these specific environmental hurdles, see our core Container OCR capabilities.

StructOCR: Engineered for Rapid National Scaling

Designed strictly as a high-performance REST API to ensure seamless integration into any new or legacy logistics software without heavy SDK dependencies, this endpoint is powered by our Logistics Container OCR engine. It features complete rotation invariance—automatically reading upside-down text from top-down yard cranes. The engine applies strict ISO 6346 validation to mathematically verify the check digit, guaranteeing absolute data integrity across massive new supply chain networks.

Core Applications for the Saudi Market

Integration & AI Prompts

Call the endpoint directly via HTTP. The API flexibly accepts standard image URLs, direct multipart file uploads, or Base64-encoded strings, accommodating varying connectivity at remote desert sites.

import requests
import base64

# Prepare Base64 Image from local Saudi port CCTV capture
with open("jeddah_gate_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 Desert Environment Capture...")
    response = requests.post(url, headers=headers, json=payload)
    result = response.json()

    if result.get('success'):
        data = result['data']['parsed']
        print("✅ Container Code Extracted!")
        print(f"Full Number:  {data.get('owner_code')}{data.get('category')}{data.get('serial_number')}-{data.get('check_digit')}")
    else:
        print(f"❌ Extraction Failed: {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"
    }
  }
}