Direct API for High-Accuracy C# National ID Extraction

// 💰 Save 30%+ vs competitors. Get 20 free credits instantly:
// 👉 https://structocr.com/register

using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Json;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;

public class NationalIdOcrExample
{
    private const string ApiKey = "YOUR_API_KEY_HERE";
    private const string ApiEndpoint = "https://api.structocr.com/v1/national-id";

    private static readonly HttpClient client = new HttpClient();

    public static async Task Main(string[] args)
    {
        string imagePath = "id_card.jpg";
        if (!File.Exists(imagePath)) return;

        try
        {
            byte[] imageBytes = await File.ReadAllBytesAsync(imagePath);
            string base64Image = Convert.ToBase64String(imageBytes);
            var payload = new { img = base64Image };

            client.DefaultRequestHeaders.Clear();
            client.DefaultRequestHeaders.Add("x-api-key", ApiKey);

            HttpResponseMessage response = await client.PostAsJsonAsync(ApiEndpoint, payload);
            string responseBody = await response.Content.ReadAsStringAsync();

            if (!response.IsSuccessStatusCode) return;

            var options = new JsonSerializerOptions { PropertyNameCaseInsensitive = true };
            var result = JsonSerializer.Deserialize<ApiResponse>(responseBody, options);

            if (result?.Success == true && result.Data != null)
            {
                var data = result.Data;
                Console.WriteLine($"ID Number:  {data.DocumentNumber}");
                Console.WriteLine($"Name:       {data.GivenNames} {data.Surname}");
                if (data.AdditionalFields != null && !string.IsNullOrEmpty(data.AdditionalFields.MrzLine1))
                {
                    Console.WriteLine($"MRZ Line 1: {data.AdditionalFields.MrzLine1}");
                }
            }
        }
        catch (Exception e) { Console.WriteLine(e.Message); }
    }
}

public class ApiResponse
{
    public bool Success { get; set; }
    public IdData Data { get; set; }
}

public class IdData
{
    [JsonPropertyName("country_code")]
    public string CountryCode { get; set; }
    [JsonPropertyName("document_number")]
    public string DocumentNumber { get; set; }
    public string Surname { get; set; }
    [JsonPropertyName("given_names")]
    public string GivenNames { get; set; }
    
    [JsonPropertyName("additional_fields")]
    public AdditionalFieldsData AdditionalFields { get; set; }
}

public class AdditionalFieldsData
{
    [JsonPropertyName("mrz_line_1")]
    public string MrzLine1 { get; set; }
    [JsonPropertyName("mrz_line_2")]
    public string MrzLine2 { get; set; }
    [JsonPropertyName("mrz_line_3")]
    public string MrzLine3 { get; set; }
}