EmiratesKit.Core 1.0.1

EmiratesKit.Core

Core validation library for UAE documents. Validates Emirates ID, UAE IBAN, Tax Registration Number (TRN), mobile numbers, and passport numbers.

Zero external dependencies. Supports .NET 6, .NET 7, and .NET 8.

This is the foundation package of the EmiratesKit family. The other packages — EmiratesKit.Annotations and EmiratesKit.FluentValidation — depend on this one and install it automatically.

Installation

dotnet add package EmiratesKit.Core

Validators

Emirates ID

Emirates ID numbers follow the format 784-YYYY-NNNNNNN-C where 784 is the UAE country code, YYYY is the holder's birth year, NNNNNNN is a 7-digit sequence number, and C is a Luhn check digit.

Both formatted input with dashes and raw 15-digit input are accepted. When dashes are provided, their positions are validated strictly — dashes in the wrong positions are rejected with INVALID_FORMAT.

using EmiratesKit.Core.Validators;

// Quick boolean check
bool isValid = EmiratesIdValidator.Check("784-1990-1234567-6");   // True

// Full result with parsed fields
var result = EmiratesIdValidator.Parse("784-1990-1234567-6");

Console.WriteLine(result.IsValid);           // True
Console.WriteLine(result.BirthYear);         // 1990
Console.WriteLine(result.ApproximateAge);    // 35
Console.WriteLine(result.SequenceNumber);    // 1234567
Console.WriteLine(result.CountryCode);       // 784
Console.WriteLine(result.CheckDigit);        // 6

// Raw digits (no dashes) are also accepted
EmiratesIdValidator.Check("784199012345676");   // True

// Invalid — wrong check digit
var bad = EmiratesIdValidator.Parse("784-1990-0000000-0");
Console.WriteLine(bad.IsValid);              // False
Console.WriteLine(bad.ErrorCode);            // INVALID_CHECKSUM
Console.WriteLine(bad.ErrorMessage);         // Emirates ID checksum is invalid (Luhn algorithm failed).

// Invalid — dashes in wrong positions
var wrongFormat = EmiratesIdValidator.Parse("7841-990-1234567-6");
Console.WriteLine(wrongFormat.ErrorCode);    // INVALID_FORMAT

Validation rules applied:

1. Input must not be null or empty
2. If dashes are present, format must be exactly 784-YYYY-NNNNNNN-C
3. Must be exactly 15 digits after removing dashes
4. Must start with country code 784
5. Birth year must be between 1900 and the current year
6. Check digit must pass the Luhn (Mod 10) algorithm

UAE IBAN

UAE IBANs follow the ISO 13616 standard. The format is AE + 2 check digits + 3-digit bank code + 16-digit account number, totalling 23 characters. Validation uses the Mod-97 algorithm.

using EmiratesKit.Core.Validators;

// Quick boolean check
bool isValid = UaeIbanValidator.Check("AE070331234567890123456");   // True

// Full result with bank details
var result = UaeIbanValidator.Parse("AE070331234567890123456");

Console.WriteLine(result.IsValid);           // True
Console.WriteLine(result.BankCode);          // 033
Console.WriteLine(result.BankName);          // Emirates NBD
Console.WriteLine(result.AccountNumber);     // 1234567890123456
Console.WriteLine(result.CheckDigits);       // 07

// Invalid — wrong check digits
var bad = UaeIbanValidator.Parse("AE990331234567890123456");
Console.WriteLine(bad.IsValid);              // False
Console.WriteLine(bad.ErrorCode);            // INVALID_CHECKSUM

Supported bank codes:

IBANs with an unrecognised bank code still pass validation if the Mod-97 check succeeds — BankName will be null in that case.

UAE Mobile

All common UAE mobile input formats are normalised and validated. The local number must have a valid UAE carrier prefix.

using EmiratesKit.Core.Validators;

// All formats are accepted
UaeMobileValidator.Check("+971501234567");    // True  — international with +
UaeMobileValidator.Check("00971501234567");   // True  — international with 00
UaeMobileValidator.Check("0501234567");       // True  — local with leading 0
UaeMobileValidator.Check("501234567");        // True  — local digits only

// Full result
var result = UaeMobileValidator.Parse("+971501234567");

Console.WriteLine(result.IsValid);            // True
Console.WriteLine(result.NormalizedNumber);   // +971501234567
Console.WriteLine(result.Prefix);             // 050
Console.WriteLine(result.Carrier);            // e& (Etisalat)

// Invalid — unknown prefix
var bad = UaeMobileValidator.Parse("+971401234567");
Console.WriteLine(bad.IsValid);               // False
Console.WriteLine(bad.ErrorCode);             // INVALID_MOBILE_PREFIX

Valid prefixes:

TRN (Tax Registration Number)

UAE TRNs are 15-digit numbers issued by the Federal Tax Authority. They must start with 100.

using EmiratesKit.Core.Validators;

UaeTrnValidator.Check("100123456700003");    // True
UaeTrnValidator.Check("200123456700003");    // False — does not start with 100
UaeTrnValidator.Check("10012345670000");     // False — only 14 digits

Passport

UAE passport numbers consist of one uppercase letter followed by exactly 7 digits.

using EmiratesKit.Core.Validators;

UaePassportValidator.Check("A1234567");    // True
UaePassportValidator.Check("12345678");    // False — no leading letter
UaePassportValidator.Check("AB123456");    // False — two letters

Dependency Injection

Register all validators with the ASP.NET Core service container in Program.cs:

using EmiratesKit.Core.Extensions;

builder.Services.AddUaeValidators();

Inject the validator interface into any service, controller, or handler:

using EmiratesKit.Core.Interfaces;

public class CustomerService
{
    private readonly IEmiratesIdValidator _emiratesIdValidator;
    private readonly IUaeIbanValidator    _ibanValidator;

    public CustomerService(
        IEmiratesIdValidator emiratesIdValidator,
        IUaeIbanValidator    ibanValidator)
    {
        _emiratesIdValidator = emiratesIdValidator;
        _ibanValidator       = ibanValidator;
    }

    public bool Onboard(string emiratesId, string iban)
    {
        var eidResult  = _emiratesIdValidator.Validate(emiratesId);
        var ibanResult = _ibanValidator.Validate(iban);

        if (!eidResult.IsValid)
            throw new ValidationException(eidResult.ErrorMessage);

        if (!ibanResult.IsValid)
            throw new ValidationException(ibanResult.ErrorMessage);

        return true;
    }
}

Using interfaces instead of the static API (EmiratesIdValidator.Check()) allows you to mock validators in unit tests.

Registered interfaces:

Error Codes

Every failed validation returns a machine-readable ErrorCode string on the result object alongside the human-readable ErrorMessage.

Important Limitation

EmiratesKit.Core performs format and checksum validation only. It does not connect to any UAE government system, database, or API.

A result of IsValid = true means the document number is structurally correct and passes its mathematical check. It does not confirm that the document was ever issued, belongs to a specific person, or remains valid.

For official verification, use the appropriate government service:

• Emirates ID: UAE Identity and Citizenship Authority (ICA)
• TRN: Federal Tax Authority (FTA) taxpayer lookup portal
• Mobile number: Telecommunications and Digital Government Regulatory Authority (TDRA)

Related Packages

License

MIT License. Copyright 2026 Akhil P Vijayan.