Skip to content

Universal identifiers

These patterns load for every call. They are not tied to one ISO-2 country plugin. Some national passports sit here because their keys have no country suffix the filter understands (US_PASSPORT, CA_PASSPORT, GB_PASSPORT).

Structural match only

A hit means the text looked like the identifier. It is not a finding that a payment network, a bank, or a passport office issued the value.

Communication and network

Type What it is Shape this package looks for Example (synthetic) Sources
EMAIL Mailbox address Local part, @, domain ada@example.com RFC 5321, RFC 5322
PHONE Telephone number Optional +, groups of digits +1 202 555 0100 ITU-T E.164
URL HTTP(S) locator http:// or https:// plus host https://example.com/a RFC 3986
IPV4_ADDRESS, IP_ADDRESS IPv4 address Four octets 0–255 192.0.2.10 RFC 791
IPV6_ADDRESS IPv6 address Colon-separated hex groups 2001:db8::1 RFC 4291
MAC_ADDRESS Hardware address Six hex octets 00:1A:2B:3C:4D:5E IEEE 802

IP_ADDRESS is a legacy alias of the IPv4 pattern.

Payments and assets

Type What it is Shape Checksum Example (synthetic) Sources
CREDIT_CARD Payment-card primary account number 13–19 digits, optional spaces or dashes Luhn (ISO/IEC 7812) 4111111111111111 ISO/IEC 7812, PCI DSS
IBAN International Bank Account Number ISO-2 + 2 check digits + BBAN ISO 13616 mod-97 DE89370400440532013000 ISO 13616-1:2020, SWIFT IBAN Registry
BIC_SWIFT Business Identifier Code 8 or 11 letters/digits none DEUTDEFF ISO 9362
CURRENCY_AMOUNT Amount with a currency code or symbol Code/symbol plus grouped digits none EUR 1,250.00 Descriptive only
CRYPTO_BTC Bitcoin address Base58 or Bech32 bc1… none bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4 BIP 173
CRYPTO_ETH Ethereum account 0x + 40 hex digits none 0x0000000000000000000000000000000000000000 Ethereum yellow paper
VIN Vehicle identification number 17 characters, no I/O/Q ISO 3779 1HGCM82633A004352 ISO 3779

A failed card, IBAN, or VIN check becomes CREDIT_CARD_LIKE, IBAN_LIKE, or VIN_LIKE.

Dates and passports stored as universal

Type What it is Shape Example (synthetic) Sources
DATE_ISO Calendar date, optional time YYYY-MM-DD and optional ISO time 2026-09-15T12:00:00Z ISO 8601
US_PASSPORT United States passport number Letter + 8 digits, or 9 digits A12345678 U.S. Department of State β€” Passports, ICAO Doc 9303
CA_PASSPORT Canadian passport number Two letters + 6 digits AB123456 IRCC β€” Canadian passports, ICAO 9303
GB_PASSPORT United Kingdom passport number issued as nine digits 9 digits 123456789 GOV.UK β€” Passports, ICAO 9303

Passports issued from 2015 use two letters and seven digits. That shape is PASSPORT_GB on the United Kingdom page, not this universal key.

Those three passport keys stay in the universal map so a --countries GB filter does not drop US_PASSPORT. That is a limitation of the current key names, not a claim that U.S. passports are issued in every country.