Luhnify is anywhere.
Validate identities globally from any environment. We offer **8 native SDKs** to integrate our algorithmic rules into your favorite tech stack.
POST /v1/validate
If you prefer not to use our SDKs, you can make a standard HTTP request. Ideal for legacy system integrations or officially unsupported languages.
cURL Request
curl -X POST https://luhnify.com/api/v1/validate \
-H "X-API-KEY: your_api_key" \
-H "Content-Type: application/json" \
-d '{
"country_code": "es",
"document_type": "dni",
"document_number": "12345678Z"
}'
JSON Response
{
"valid": true,
"message": "Document validated successfully"
}
| Parameter | Type | Description |
|---|---|---|
| country_code | string | ISO Code (es, us, fr...). See list |
| document_type | string | Document identifier (dni, nie, nif...). |
| document_number | string | The string to be validated. |
Official SDKs
composer require luhnify/luhnify-php
$luhnify = new \Luhnify\ValidationSdk\ValidationClient($apiKey);
$result = $luhnify->ValidateDocument(new \Luhnify\ValidationSdk\ValidationPayload([
'country_code' => 'es',
'document_type' => 'dni',
'document_number' => '12345678Z'
]));
npm install @luhnify/luhnify-ts
const client = new ValidationClient(apiKey);
const result = await client.validateDocument({
country_code: 'es',
document_type: 'dni',
document_number: '12345678Z'
});
implementation 'com.luhnify:luhnify-java:1.0.0'
ValidationClient client = new ValidationClient(apiKey);
ValidationResult result = client.validateDocument(new ValidationPayload(
"es",
"dni",
"12345678Z"
));
go get github.com/Luhnify/luhnify-go
package main
import (
"fmt"
"github.com/Luhnify/luhnify-go/validation"
)
func main() {
apiKey := "YOUR_API_KEY_HERE"
client := validation.NewValidationClient(apiKey, nil)
payload := validation.ValidationPayload{
CountryCode: "es",
DocumentType: "dni",
DocumentNumber: "12345678Z",
}
result, err := client.ValidateDocument(payload)
if err != nil {
fmt.Printf("Validation error: %v\n", err)
return
}
if result.Valid {
fmt.Println("Success: The document is valid.")
} else {
fmt.Println("Warning: The document is invalid.")
}
}
dotnet add package Luhnify.SDK
using Luhnify.SDK;
using Luhnify.SDK.src.Models;
var client = new ValidationClient("your_api_key");
var payload = new ValidationPayload
{
CountryCode = "ES",
DocumentType = "DNI",
DocumentNumber = "12345678Z"
};
try
{
ValidationResult result = await client.ValidateDocumentAsync(payload);
if (result.IsValid)
{
Console.WriteLine("Document is valid!");
}
else
{
Console.WriteLine($"Invalid document. Reason: {result.Error}");
}
}
catch (Exception ex)
{
Console.WriteLine($"Error connecting to Luhnify: {ex.Message}");
}
Add the dependency to your Package.swift:
.package(url: "https://github.com/Luhnify/luhnify-swift.git", from: "1.0.0")
And add the product to your target dependencies:
.product(name: "LuhnifySDK", package: "luhnify-swift")
Basic usage example in Swift:
import LuhnifySDK
import Foundation
// 1. Initialize the client with your API Key
let client = ValidationClient(apiKey: "your_api_key_here")
// 2. Perform the validation using modern Swift concurrency (async/await)
Task {
do {
let result = try await client.validateDocument(
countryCode: "ES",
documentType: "DNI",
documentNumber: "12345678Z"
)
if result.isValid {
print("Document is valid!")
} else {
print("Invalid document. Reason: \(result.error ?? "Unknown error")")
}
} catch {
print("Error connecting to Luhnify: \(error.localizedDescription)")
}
}
Add the dependency to your build.gradle.kts:
dependencies {
implementation("com.luhnify:luhnify-sdk-kotlin:1.0.0")
}
Basic usage example in Kotlin (using Coroutines):
import com.luhnify.sdk.ValidationClient
import kotlinx.coroutines.runBlocking
fun main() = runBlocking {
// 1. Initialize the client with your API Key
val client = ValidationClient(apiKey = "your_api_key_here")
try {
// 2. Perform the validation (suspend function)
val result = client.validateDocument(
countryCode = "ES",
documentType = "DNI",
documentNumber = "12345678Z"
)
if (result.isValid) {
println("Document is valid!")
} else {
println("Invalid document. Reason: ${result.error ?: "Unknown error"}")
}
} catch (e: Exception) {
println("Error connecting to Luhnify: ${e.localizedMessage}")
}
}
Install the package via pip:
pip install luhnify-validation
Or with Django support if needed:
pip install luhnify-validation[django]
Basic usage example in Python:
from luhnify_validation import ValidationClient
# 1. Initialize the client with your API Key
client = ValidationClient(api_key="your_api_key_here")
try:
# 2. Perform the validation
result = client.validate_document(
country_code="ES",
document_type="DNI",
document_number="12345678Z"
)
if result.is_valid:
print("Document is valid!")
else:
print(f"Invalid document. Reason: {result.error}")
except Exception as e:
print(f"Error connecting to Luhnify: {e}")
Supported Countries
Rules obtained dynamically from the algorithmic engine.
Pasaporte
document_type: passportExample: A1234567
ID Card
document_type: idExample: J12345678A
Numéro d'Identification Nationale (NIN)
document_type: ninExample: 123456789012345678
Número de Passaport
document_type: passportExample: AB1234567
Cartão de Contribuinte (Tax ID)
document_type: contribuinteExample: 123456789
Social Security
document_type: ssnExample: 123456789
Código Único de Identificación Tributaria (CUIT)
document_type: cuitExample: 30-68537634-9
Documento Nacional de Identidad (DNI)
document_type: dniExample: 12345678
Social Security
document_type: ssnExample: 1234567890
ID Card
document_type: idExample: 1234567890
Tax File Number (TFN)
document_type: tfnExample: 123456789
ID Card Number
document_type: idExample: A12345678
Passport
document_type: passportExample: 1234567
Sozialversicherungsnummer (SVN)
document_type: svnExample: 1751 080851
FIN (Individual Identification Number)
document_type: finExample: 1234567
National ID
document_type: nidExample: 123456789
CPR Number
document_type: idExample: 123456789
National ID (NID)
document_type: nidExample: 1234567890
ID Card
document_type: idExample: 1234567890
Pasaporte
document_type: passportExample: AB1234567
Numéro National (National Number)
document_type: nnExample: 53020406105
Passport
document_type: passportExample: AB1234567
eID (ID Card Number)
document_type: idExample: 123456789012
Social Security
document_type: idExample: 123456789
ID Card
document_type: idExample: 1234567890123
National ID
document_type: nidExample: 12345678901
Cédula de Identidad (CI)
document_type: ciExample: 1234567-SC
Passport
document_type: passportExample: AB1234567
Registro Único Nacional (RUN)
document_type: runExample: 12345678
Identity Card
document_type: idExample: 123456789
Identity Card
document_type: idExample: 123456789
Cadastro Nacional da Pessoa Jurídica (CNPJ)
document_type: cnpjExample: 12.345.678/0001-00
Cadastro de Pessoas Físicas (CPF)
document_type: cpfExample: 123.456.789-09
Pasaporte
document_type: passportExample: A1234567
EGN (Uniform Civil Number)
document_type: egnExample: 1234567890
Passport
document_type: passportExample: AB1234567
ID Card
document_type: idExample: 1234567890
Pasaporte
document_type: passportExample: A1234567
National ID
document_type: nidExample: 123456789
Carte Nationale d'Identité (CNI)
document_type: cniExample: 1234567890AB
Passport
document_type: passportExample: AB123456
Social Insurance Number (SIN)
document_type: sinExample: 046-454-286
National ID
document_type: nidExample: 123456789012
National ID
document_type: nidExample: 12345678
Pasaporte
document_type: passportExample: CF1234567
Pasaporte
document_type: passportExample: P1234567
Cédula de Identidad
document_type: idExample: 12345678-9
Rol Único Tributario (RUT)
document_type: rutExample: 12345678-5
Passport
document_type: passportExample: E12345678
Resident Identity Card Number
document_type: idExample: 11010519491231002X
Cédula de Ciudadanía (CC)
document_type: ccExample: 1020304050
Cédula de Extranjería (CE)
document_type: ceExample: 50000000
Número de Identificación Tributaria (NIT)
document_type: nitExample: 800197268-4
Passport
document_type: passportExample: 123456789
Pasaporte
document_type: passportExample: CO1234567
Cédula de Identidad
document_type: cedulaExample: 1-1234-5678
OIB (Personal Identification Number)
document_type: oibExample: 12345678903
Passport
document_type: passportExample: AB1234567
Carné de Identidad (CI)
document_type: ciExample: 90010112345
Passport
document_type: passportExample: AB123456
ID Card Number
document_type: idExample: 12345678A
Passport
document_type: passportExample: AB1234567
Passport
document_type: passportExample: 12345678
Rodné číslo (National ID)
document_type: rnExample: 900101/0007
ID Card
document_type: idExample: 1234567890
CPR-nummer (Civil Registration Number)
document_type: idExample: 010190-1510
Passport
document_type: passportExample: AA1234567
Pasaporte
document_type: passportExample: D1234567
National ID
document_type: nidExample: 1234567890
Cédula de Identidad y Electoral
document_type: cedulaExample: 001-1234567-8
Cédula de Identidad
document_type: ciExample: 1712345675
Registro Único de Contribuyentes (RUC)
document_type: rucExample: 1234567890001
National ID Card Number
document_type: national_idExample: 12345678901234
Documento Único de Identidad (DUI)
document_type: duiExample: 03883848-7
Número de Identificación Tributaria (NIT)
document_type: nitExample: 0614-110895-108-1
Passport
document_type: passportExample: AB1234567
Pasaporte
document_type: passportExample: A123456
Pasaporte
document_type: passportExample: A1234567
Isikukood (Personal ID)
document_type: idExample: 37605030299
Passport
document_type: passportExample: AB1234567
National ID
document_type: idExample: 1234567890123
National ID
document_type: idExample: 1234567890123
TIN (Tax ID)
document_type: tinExample: 12345678
Henkilötunnus (HETU)
document_type: idExample: 111111-111C
Passport
document_type: passportExample: AB1234567
Carte Nationale d'Identité (CNI)
document_type: cniExample: 123456789012
Passport
document_type: passportExample: 12AB34567
Pasaporte
document_type: passportExample: AB123456
Identity Card
document_type: idExample: 1234567890
ID Card Number
document_type: idExample: 12345678901
Passport
document_type: passportExample: M123456789
Personalausweis (ID Card)
document_type: idExample: M123456789Z
Ghana Card Number
document_type: ghana_cardExample: GHA-000000000-0
AFM (VAT/Tax Number)
document_type: afmExample: 123456734
Arithmos Tautotitas (ID Card)
document_type: idExample: AB123456
National ID
document_type: nidExample: 123456789012
Numéro d'Inscription (Seguridad Social)
document_type: nirExample: 123456789012345
Código Único de Identificación (CUI)
document_type: cuiExample: 1234 56789 0101
Pasaporte
document_type: passportExample: AB1234567
Pasaporte
document_type: passportExample: AB1234567
National ID
document_type: idExample: 123456789
Carte d'Identification Nationale (CIN)
document_type: cinExample: 1234567890
Documento Nacional de Identificación (DNI)
document_type: dniExample: 1234567890123
Passport
document_type: passportExample: AB1234567
Személyi Azonosító (ID Card)
document_type: idExample: 123456AB
Kennitala (ID)
document_type: ktExample: 123456-7890
Aadhaar (UID)
document_type: aadhaarExample: 1234 5678 9012
PAN (Permanent Account Number)
document_type: panExample: ABCDE1234F
Nomor Induk Kependudukan (NIK)
document_type: nikExample: 1234567890123456
National ID
document_type: nidExample: 1234567890
National ID
document_type: nidExample: 123456789012
Passport
document_type: passportExample: A1234567
Personal Public Service Number (PPSN)
document_type: ppsnExample: 1234567TW
Passport
document_type: passportExample: AB1234567
Teudat Zehut (ID Card Number)
document_type: teudat_zehutExample: 123456789
Carta d'Identità Elettronica (CIE)
document_type: idExample: CA12345BA1234567
Codice Fiscale
document_type: cfExample: RSSMRA98S08H501H
Passport
document_type: passportExample: AB1234567
National ID
document_type: idExample: C0123456789
National Insurance Scheme (NIS)
document_type: nisExample: 123456789
Tax Registration Number (TRN)
document_type: trnExample: 123456789
My Number (Social Security)
document_type: mynumberExample: 1234-5678-9012
Passport
document_type: passportExample: AB1234567
National ID
document_type: national_idExample: 1234567890
ID Card Number
document_type: idExample: 123456789
IIN (Individual Identification Number)
document_type: iinExample: 123456789012
National Identity Card Number
document_type: idExample: 12345678
National ID
document_type: nidExample: 1234567
Civil ID
document_type: civil_idExample: 123456789012
Personal Number
document_type: idExample: 12345678901234
Pasaporte
document_type: passportExample: P1234567
Passport
document_type: passportExample: AB1234567
Personas kods (Personal Code)
document_type: idExample: 123456-12345
National ID
document_type: idExample: 123456789012
Identity Card
document_type: idExample: 123456789012
Pasaporte
document_type: passportExample: L1234567
National ID
document_type: nidExample: 119901234567
Identity Card
document_type: idExample: 1234567
Asmens kodas (Personal ID)
document_type: idExample: 38001010009
Passport
document_type: passportExample: AB1234567
Numéro d'identité
document_type: idExample: 1234567890123
Passport
document_type: passportExample: AB1234567
National ID
document_type: idExample: 123456789012
National ID
document_type: nidExample: 1234567890
MyKad (National ID)
document_type: mykadExample: 900101-01-1234
National ID
document_type: idExample: 1234567
ID Card
document_type: idExample: 12345678A
ID Card Number
document_type: idExample: 1234567A
Passport
document_type: passportExample: AB1234567
Social Security (SSN)
document_type: ssnExample: 123456789
Numéro d'Inscription (Seguridad Social)
document_type: nirExample: 123456789012345
NNI
document_type: idExample: 1234567890
National ID
document_type: idExample: A1234567890123
Clave Única de Registro de Población (CURP)
document_type: curpExample: ABCD123456HJKLMN01
Identificación Nacional Electoral (INE)
document_type: ineExample: 1234567890123
Registro Federal de Contribuyentes (RFC)
document_type: rfcExample: HEGJ820506M13
Social Security (SSN)
document_type: ssnExample: 123456789
IDNP (ID)
document_type: idnpExample: 1234567890123
ID Card
document_type: idExample: 12345678
Registration Number
document_type: idExample: AA12345678
Identity Card
document_type: idExample: 123456789
Carte d'Identité Nationale (CIN)
document_type: cinExample: AB123456
NUIT (Tax ID)
document_type: nuitExample: 123456789A
National ID (NRC)
document_type: nrcExample: 123456/AABB/123456
Identity Card
document_type: idExample: 12345678901
National ID
document_type: nidExample: 12345
Pasaporte
document_type: passportExample: 12345678
Burgerservicenummer (BSN)
document_type: bsnExample: 111222333
Passport
document_type: passportExample: AB1234567
IRD Number (Tax)
document_type: irdExample: 123456789
Cédula de Identidad Ciudadana
document_type: cedulaExample: 001-010190-0000A
ID Card
document_type: idExample: 1234567890
National Identification Number (NIN)
document_type: ninExample: 12345678901
Tax Identification Number (TIN)
document_type: tinExample: 1234567890
Pasaporte
document_type: passportExample: 123456789
Identity Card
document_type: idExample: 12345678
Fødselsnummer (ID)
document_type: fnrExample: 12345678901
Civil Number
document_type: idExample: 12345678
National ID (CNIC)
document_type: cnicExample: 12345-6789012-3
National ID
document_type: nidExample: 12345
ID Card
document_type: idExample: 123456789
Cédula de Identidad Personal
document_type: cedulaExample: 8-400-1234
National ID
document_type: nidExample: 123456789012345
Cédula de Identidad
document_type: ciExample: 1234567
Documento Nacional de Identidad (DNI)
document_type: dniExample: 1234567C
Registro Único de Contribuyentes (RUC)
document_type: rucExample: 12345678901
Tax Identification Number (TIN)
document_type: tinExample: 123-456-789-000
Unified Multi-Purpose ID (UMID)
document_type: umidExample: 123456789012
PESEL (National ID)
document_type: peselExample: 90010112349
Passport
document_type: passportExample: AB1234567
Cartão de Cidadão
document_type: idExample: 12345678 9
Número de Identificação Fiscal (NIF)
document_type: nifExample: 123456789
Passport
document_type: passportExample: AB123456
Seguro Social (Similar a US SSN)
document_type: ssnExample: 123-45-6789
National ID
document_type: nidExample: 1234567890
Carte Nationale d'Identité (CNI)
document_type: idExample: AB1234567890
Numéro d'Identification Nationale (NIN)
document_type: ninExample: 12345678901
Cod Numeric Personal (CNP)
document_type: cnpExample: 1234567890128
Passport
document_type: passportExample: AB1234567
Internal Passport (Serie and Number)
document_type: passportExample: 1234 567890
SNILS (Insurance Number)
document_type: snilsExample: 123-456-789 00
National ID
document_type: idExample: 1199080000000000
Pasaporte
document_type: passportExample: K1234567
National ID
document_type: nidExample: 123456789012
National ID
document_type: nidExample: 12345678
National ID
document_type: nidExample: 12345
ID Card
document_type: idExample: 12345
Pasaporte
document_type: passportExample: ST1234567
National ID / Iqama Number
document_type: national_idExample: 1234567890
Numéro d'Identification Nationale (NIN)
document_type: ninExample: 1234567890123
Identity Card
document_type: idExample: 123456789
Pasaporte
document_type: passportExample: S1234567
National ID
document_type: nidExample: 12345678901
NRIC/FIN (National ID)
document_type: nric_finExample: S1234567A
Passport
document_type: passportExample: AB1234567
Rodné číslo (National ID)
document_type: rnExample: 900101/0007
EMATČINA ŠT. (Unique Master Citizen Number)
document_type: emsoExample: 1234567890125
Passport
document_type: passportExample: AB1234567
National ID
document_type: nidExample: 1234567
National ID
document_type: nidExample: AB12345
National ID Number
document_type: idExample: 9001015000084
Tax Reference Number (ITR12)
document_type: taxExample: 1234567890
Passport
document_type: passportExample: M12345678
Resident Registration Number (RRN)
document_type: resident_idExample: 900101-1234567
Pasaporte
document_type: passportExample: A1234567
DNI
document_type: dniExample: 12345678Z
NIE
document_type: nieExample: X1234567L
NIF (Empresas)
document_type: nifExample: A83790584
Pasaporte
document_type: passportExample: ABC123456
National ID (NIC)
document_type: nicExample: 123456789V
National ID
document_type: nidExample: 123456789012
ID Card
document_type: idExample: 12345678
Passport
document_type: passportExample: 12345678
Personnummer (Personal ID)
document_type: pnExample: 19811218-9876
Social Security (AHV)
document_type: ahvExample: 123.4567.8901.23
National ID
document_type: idExample: 01234567890
Pasaporte
document_type: passportExample: A12345678
National Identification Number (NIN)
document_type: ninExample: 1234567890123456
Tax Identification Number (TIN)
document_type: tinExample: 123456789
National ID Card Number
document_type: national_idExample: 1234567890123
Pasaporte
document_type: passportExample: P1234567
National ID
document_type: nidExample: 123456789012
National ID
document_type: nidExample: 123456
National ID Card Number
document_type: idExample: 123456789
Carte d'Identité Nationale (CIN)
document_type: cinExample: 12345678
TC Kimlik No (National ID)
document_type: tc_kimlikExample: 12345678901
Vergi Numarası (Tax Number)
document_type: vergi_noExample: 1234567890
Pasaporte
document_type: passportExample: AA123456
National ID
document_type: nidExample: 1234
National Identification Number (NIN)
document_type: ninExample: AB12345678901234
Identity Card
document_type: idExample: 123456789
Emirates ID Number
document_type: emirates_idExample: 784-2015-123456-7
National Insurance Number (NINO)
document_type: ninoExample: AB123456C
Passport
document_type: passportExample: 502135648
Driver License (Alabama)
document_type: driver_license_alExample: 12345678
Driver License (Alaska)
document_type: driver_license_akExample: 1234567
Driver License (Arizona)
document_type: driver_license_azExample: A12345678
Driver License (Arkansas)
document_type: driver_license_arExample: 999000680
Driver License (California)
document_type: driver_license_caExample: A1234567
Driver License (Colorado)
document_type: driver_license_coExample: 943301010
Driver License (Connecticut)
document_type: driver_license_ctExample: 146825129
Driver License (D.C.)
document_type: driver_license_dcExample: 1234567
Driver License (Delaware)
document_type: driver_license_deExample: 1232805
Driver License (Florida)
document_type: driver_license_flExample: G544061739250
Driver License (Georgia)
document_type: driver_license_gaExample: 099999999
Driver License (Hawaii)
document_type: driver_license_hiExample: H00000002
Driver License (Idaho)
document_type: driver_license_idExample: AA123456Z
Driver License (Illinois)
document_type: driver_license_ilExample: H12345678901
Driver License (Indiana)
document_type: driver_license_inExample: 1234567890
Driver License (Iowa)
document_type: driver_license_iaExample: 123456789
Driver License (Kansas)
document_type: driver_license_ksExample: K12345678
Driver License (Kentucky)
document_type: driver_license_kyExample: A12345678
Driver License (Louisiana)
document_type: driver_license_laExample: 099999999
Driver License (Maine)
document_type: driver_license_meExample: 1234567A
Driver License (Maryland)
document_type: driver_license_mdExample: B123456789012
Driver License (Massachusetts)
document_type: driver_license_maExample: S12345678
Driver License (Michigan)
document_type: driver_license_miExample: A000000000000
Driver License (Minnesota)
document_type: driver_license_mnExample: A123456789012
Driver License (Mississippi)
document_type: driver_license_msExample: 123456789
Driver License (Missouri)
document_type: driver_license_moExample: B123456789
Driver License (Montana)
document_type: driver_license_mtExample: 123456789
Driver License (Nebraska)
document_type: driver_license_neExample: A12345678
Driver License (Nevada)
document_type: driver_license_nvExample: 123456789012
Driver License (New Hampshire)
document_type: driver_license_nhExample: 00ABC12345
Driver License (New Jersey)
document_type: driver_license_njExample: A12345678901234
Driver License (New Mexico)
document_type: driver_license_nmExample: 123456789
Driver License (New York)
document_type: driver_license_nyExample: 123456789
Driver License (North Carolina)
document_type: driver_license_ncExample: 123456789012
Driver License (North Dakota)
document_type: driver_license_ndExample: ABC123456
Driver License (Ohio)
document_type: driver_license_ohExample: AA123456
Driver License (Oklahoma)
document_type: driver_license_okExample: 123456789
Driver License (Oregon)
document_type: driver_license_orExample: 123456789
Driver License (Pennsylvania)
document_type: driver_license_paExample: 12345678
Driver License (Rhode Island)
document_type: driver_license_riExample: V123456
Driver License (South Carolina)
document_type: driver_license_scExample: 12345678901
Driver License (South Dakota)
document_type: driver_license_sdExample: 12345678
Driver License (Tennessee)
document_type: driver_license_tnExample: 123456789
Driver License (Texas)
document_type: driver_license_txExample: 12345678
Driver License (Utah)
document_type: driver_license_utExample: 1234567890
Driver License (Vermont)
document_type: driver_license_vtExample: 1234567A
Driver License (Virginia)
document_type: driver_license_vaExample: B12345678901
Driver License (Washington)
document_type: driver_license_waExample: WDLABC*0123B
Driver License (West Virginia)
document_type: driver_license_wvExample: 1234567
Driver License (Wisconsin)
document_type: driver_license_wiExample: A1234567890123
Driver License (Wyoming)
document_type: driver_license_wyExample: 123456789
Passport
document_type: passportExample: 123456789
Social Security Number (SSN)
document_type: ssnExample: 123-45-6789
Cédula de Identidad
document_type: ciExample: 1.234.567-8
PINFL (Personal Identification Number)
document_type: pinflExample: 12345678901234
National ID
document_type: nidExample: 12345678
Passport
document_type: passportExample: AB1234567
Cédula de Identidad (CI)
document_type: ciExample: V-12345678
Registro de Información Fiscal (RIF)
document_type: rifExample: J12345678-0
National ID (NIN)
document_type: ninExample: 123456789
Pasaporte
document_type: passportExample: 12345678
National ID
document_type: nidExample: 123456/01/1
National ID
document_type: nidExample: 01-123456A01