Developer Documentation

using KadoeApi;

// Initialize the client (defaults to https://kadoefinder.com)
var client = new KadoeApiClient("YOUR_API_KEY");

// Single KADOE query (idempotency key is required)
var result = await client.QueryVehicleAsync(
    registrationNumber: "AB12CDE",
    eventDate: "2025-01-15",
    idempotencyKey: $"query-{Guid.NewGuid()}"  // Required
);

if (result.Success)
{
    // Vehicle details
    Console.WriteLine($"Vehicle: {result.Vehicle.Make} {result.Vehicle.Model}");

    // Check for stolen/exported/scrapped
    if (result.Vehicle.HasMessage)
        Console.WriteLine($"Status: {result.Vehicle.Message}");

    // Keeper details (personal or company)
    if (result.Keeper.IsCompany)
        Console.WriteLine($"Company: {result.Keeper.CompanyName}");
    else
        Console.WriteLine($"Keeper: {result.Keeper.FullName}");

    // Address (up to 5 lines)
    Console.WriteLine($"Address: {result.Keeper.Address.GetFormattedAddress()}");
}

// Bulk query
var queries = new List<VehicleQuery>
{
    new VehicleQuery { RegistrationNumber = "AB12CDE", EventDate = "2025-01-15" },
    new VehicleQuery { RegistrationNumber = "FG34HIJ", EventDate = "2025-01-20" }
};

var bulkResult = await client.QueryVehiclesAsync(
    queries,
    idempotencyKey: $"bulk-{Guid.NewGuid()}"  // Required
);

Console.WriteLine($"Processed: {bulkResult.QueriesProcessed}");
Console.WriteLine($"Credits used: {bulkResult.CreditsUsed}");