Direct API for C# Driver's License Data Extraction

// Get 200 free credits:
// 👉 https://structocr.com/register

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

public class StructOcrExample
{
    private static readonly HttpClient client = new HttpClient();

    public static async Task Main(string[] args)
    {
        var imagePath = "path/to/your/license.jpg";
        var endpointUrl = "https://api.structocr.com/v1/driver-license";
        var apiKey = "YOUR_API_KEY"; // Get this from your dashboard

        try
        {
            // 1. Read image file and convert to Base64
            byte[] imageBytes = await File.ReadAllBytesAsync(imagePath);
            string base64Image = Convert.ToBase64String(imageBytes);

            // 2. Prepare Request
            // Important: Add the x-api-key header
            client.DefaultRequestHeaders.Clear();
            client.DefaultRequestHeaders.Add("x-api-key", apiKey);

            var payload = new { img = base64Image };

            // 3. Send POST (PostAsJsonAsync automatically sets Content-Type: application/json)
            Console.WriteLine($"Sending request to {endpointUrl}...");
            HttpResponseMessage response = await client.PostAsJsonAsync(endpointUrl, payload);

            // 4. Handle Errors & Parse Response
            string responseBody = await response.Content.ReadAsStringAsync();
            
            if (!response.IsSuccessStatusCode)
            {
                Console.WriteLine($"API Error ({response.StatusCode}): {responseBody}");
                return;
            }

            var options = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
            StructOcrResponse? ocrResult = JsonSerializer.Deserialize<StructOcrResponse>(responseBody, options);

            if (ocrResult != null && ocrResult.Success && ocrResult.Data != null)
            {
                Console.WriteLine("Extraction Successful!");
                Console.WriteLine($"Document Number: {ocrResult.Data.DocumentNumber}");
                Console.WriteLine($"Name: {ocrResult.Data.GivenNames} {ocrResult.Data.Surname}");
                Console.WriteLine($"Region: {ocrResult.Data.Region} ({ocrResult.Data.CountryCode})");
                
                // Highlighting the advanced security feature extraction
                if (ocrResult.Data.ExtraDetails?.CardSecurityNumber != null)
                {
                    Console.WriteLine($"Security Code (DD): {ocrResult.Data.ExtraDetails.CardSecurityNumber}");
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine($"An unexpected error occurred: {e.Message}");
        }
    }
}

// Response Models matching the API Schema
public record StructOcrResponse(bool Success, LicenseData? Data);

public record LicenseData(
    [property: JsonPropertyName("type")] string Type,
    [property: JsonPropertyName("country_code")] string CountryCode,
    [property: JsonPropertyName("region")] string Region,
    [property: JsonPropertyName("document_number")] string DocumentNumber,
    [property: JsonPropertyName("personal_number")] string? PersonalNumber,
    [property: JsonPropertyName("surname")] string Surname,
    [property: JsonPropertyName("given_names")] string GivenNames,
    [property: JsonPropertyName("date_of_birth")] string DateOfBirth,
    [property: JsonPropertyName("date_of_expiry")] string DateOfExpiry,
    [property: JsonPropertyName("date_of_issue")] string DateOfIssue,
    [property: JsonPropertyName("sex")] string Sex,
    [property: JsonPropertyName("address")] string Address,
    [property: JsonPropertyName("vehicle_class")] string VehicleClass,
    [property: JsonPropertyName("extra_details")] ExtraDetailsData? ExtraDetails
);

public record ExtraDetailsData(
    [property: JsonPropertyName("card_security_number")] string? CardSecurityNumber,
    [property: JsonPropertyName("fathers_name")] string? FathersName,
    [property: JsonPropertyName("mothers_name")] string? MothersName,
    [property: JsonPropertyName("rg_number")] string? RgNumber
);