Personal ID

Generate, validate, and parse national identity numbers for 97 countries with checksum verification (SSN, CPF, Aadhaar, PESEL, etc.).

Generate

Rust

#![allow(unused)]
fn main() {
use rand::thread_rng;
use idsmith::personal_id::{GenOptions, date::Gender};

let mut rng = thread_rng();
let registry = idsmith::personal_ids();

// Default options (random gender, random year)
let id = registry.generate("EE", &Default::default(), &mut rng).unwrap();

// With gender and year
let opts = GenOptions {
    gender: Some(Gender::Female),
    year: Some(1990),
};
let id = registry.generate("EE", &opts, &mut rng).unwrap();
}

Python

import idsmith

# Default options
code = idsmith.PersonalId.generate("EE")

# With gender and year
code = idsmith.PersonalId.generate("EE", gender="female", year=1990)

JavaScript

const { PersonalId } = require('idsmith');

// Default options
const code = PersonalId.generate('EE');

// With gender and year
const code2 = PersonalId.generate('EE', 'female', 1990);

Validate

Rust

#![allow(unused)]
fn main() {
let valid = idsmith::personal_ids().validate("US", "446-72-2445").unwrap();
}

Python

valid = idsmith.PersonalId.validate("US", "446-72-2445")  # True

JavaScript

const valid = PersonalId.validate('US', '446-72-2445');  // true

Parse

Extract metadata (date of birth, gender) from an ID.

Rust

#![allow(unused)]
fn main() {
let result = idsmith::personal_ids().parse("EE", "49001011234").unwrap();
// result.dob    → Some("1990-01-01")
// result.gender → Some("female")
// result.valid  → true
}

Python

result = idsmith.PersonalId.parse("EE", "49001011234")
# result["dob"]    → "1990-01-01"
# result["gender"] → "female"
# result["valid"]  → True

JavaScript

const result = PersonalId.parse('EE', '49001011234');
// result.dob    → '1990-01-01'
// result.gender → 'female'
// result.valid  → true

Checksum-Verified Countries (56)