Call a Weighbridge Ticket OCR API from C#

Why Weighbridge Tickets Need More Than Plain OCR

A scale ticket may place the same three measurements in different rows, reverse the order of the first and second weighing, abbreviate units, or mix ticket, vehicle, job, and material identifiers. A generic OCR engine returns text but leaves your application to decide which value is gross, tare, or net. That brittle parsing becomes harder across quarry, waste, grain, logistics, and recycling layouts.

A Structured C# / .NET Workflow

The StructOCR Weighbridge Ticket OCR API returns a stable schema for ticket, facility, vehicle, material, and weight data. It preserves each printed value, normalizes supported units to kilograms, and runs deterministic gross-minus-tare validation. Test a sample first with the free weighbridge ticket scanner, then use the same endpoint in C# / .NET.

Where C# / .NET Teams Use Weighbridge OCR

• Transport and Dispatch: Match ticket numbers and vehicle registrations to loads without retyping paper tickets.
• Quarry and Waste Operations: Capture material, customer, job, gross, tare, and net values for downstream reconciliation.
• Exception Review: Route missing weights, unit issues, or printed net mismatches to a human using machine-readable review reasons.

Implementation: C# with HttpClient

The request uses POST /v1/weighbridge-ticket. Send one Base64-encoded JPG, PNG, WebP, or PDF in the img property and allow a 60-second client timeout. See the complete API reference for the full response and error contract.

Prerequisite: .NET 8+ and `System.Net.Http.Json`

using System.Net.Http.Json;
using System.Text.Json;

using var http = new HttpClient { Timeout = TimeSpan.FromSeconds(60) };
http.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var bytes = await File.ReadAllBytesAsync("weighbridge-ticket.jpg");
var payload = new { img = Convert.ToBase64String(bytes) };

using var response = await http.PostAsJsonAsync(
    "https://api.structocr.com/v1/weighbridge-ticket",
    payload
);
response.EnsureSuccessStatusCode();

using var result = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
var data = result.RootElement.GetProperty("data");
Console.WriteLine($"Ticket: {data.GetProperty("ticket_number").GetString()}");
Console.WriteLine($"Net kg: {data.GetProperty("weights").GetProperty("net").GetProperty("normalized_kg")}");
Console.WriteLine($"Needs review: {data.GetProperty("validation").GetProperty("needs_review")}");

Example Validated JSON Response

The API separates extracted fields from deterministic validation so your application can store the record and make an explicit review decision.

{
  "success": true,
  "data": {
    "is_weighbridge_ticket": true,
    "document_type": "generic_weighbridge_ticket",
    "ticket_number": "1042",
    "facility": {
      "name": "North Yard Scale",
      "address": null,
      "scale_id": "SCALE-2"
    },
    "vehicle": {
      "registration": "AB12 CDE",
      "trailer_registration": null,
      "fleet_number": null,
      "driver_name": null
    },
    "material": {
      "description": "Recycled aggregate",
      "code": "RA20"
    },
    "weights": {
      "gross": {
        "value": 25330,
        "unit": "kg",
        "raw": "25,330 kg",
        "normalized_kg": 25330
      },
      "tare": {
        "value": 6770,
        "unit": "kg",
        "raw": "6,770 kg",
        "normalized_kg": 6770
      },
      "net": {
        "value": 18560,
        "unit": "kg",
        "raw": "18,560 kg",
        "normalized_kg": 18560
      }
    },
    "confidence": "high",
    "is_valid": true,
    "validation_error": null,
    "validation": {
      "calculated_net_kg": 18560,
      "difference_kg": 0,
      "weight_check_passed": true,
      "needs_review": false,
      "review_reasons": []
    }
  }
}