United States (US)¶
National-ID patterns loaded when you pass countries=["US"] (or "all"). Universal patterns always stay.
This is a detector, not a legal opinion
id-extract matches the shape of these numbers. A hit is not proof that the value was issued, is still valid, or that the cited statute applies to your document. Checksums, where present, only test the extra digit.
SSN_US β Social Security number (SSN)¶
A nine-digit number assigned by the Social Security Administration to record earnings and administer benefits. It is also used as a taxpayer identifier. Area numbers 000 and 666, group 00, and serial 0000 are not issued.
| Package type | SSN_US |
| Shape this package looks for | AAA-GG-SSSS, excluding area 000 and 666, group 00, and serial 0000 |
| Checksum | none; those unissued groups are excluded from the expression |
| Example (synthetic) | 123-45-6789 |
Official sources
- SSA β request a Social Security number
- SSA POMS RM 10201.030 β structure of the SSN
- Social Security Act
SSN β SSN (legacy key)¶
Same pattern as SSN_US, including the excluded area, group, and serial. Kept so older callers that ask for type SSN still match.
| Package type | SSN |
| Shape this package looks for | AAA-GG-SSSS, excluding area 000 and 666, group 00, and serial 0000 |
| Checksum | none; those unissued groups are excluded from the expression |
| Example (synthetic) | 123-45-6789 |
Official sources
EIN_US β Employer Identification Number (EIN)¶
A nine-digit federal tax identifier the IRS assigns to businesses, estates, trusts, and other entities. Form SS-4 is the application.
| Package type | EIN_US |
| Shape this package looks for | NN-NNNNNNN |
| Checksum | none |
| Example (synthetic) | 12-3456789 |
Official sources
MEDICAL_NPI_US β National Provider Identifier (NPI)¶
A 10-digit identifier for covered health-care providers under HIPAA Administrative Simplification. CMS assigns it through NPPES. The first digit is 1 or 2.
| Package type | MEDICAL_NPI_US |
| Shape this package looks for | 10 digits, first digit 1 or 2 |
| Checksum | Luhn over prefix 80840 + the 10 digits (CMS) |
| Example (synthetic) | 1234567893 |
Official sources
DRIVERS_LICENSE_US β Driver licence (state)¶
Each U.S. state issues its own licence. There is no single federal format. This pattern is deliberately broad.
| Package type | DRIVERS_LICENSE_US |
| Shape this package looks for | 1β2 letters + 6β8 digits, or 8β9 digits, or 1 letter + 7β8 digits |
| Checksum | none |
| Example (synthetic) | D1234567 |
Official sources
MEDICAL_LICENSE_US β Medical or DEA-style licence (structural)¶
A coarse pattern for U.S. professional or DEA-style licence tokens. It is not a complete DEA or state-board recognizer.
| Package type | MEDICAL_LICENSE_US |
| Shape this package looks for | 1β2 letters + 6β9 digits |
| Checksum | none |
| Example (synthetic) | AB1234567 |
Official sources
ITIN_US β Individual Taxpayer Identification Number (ITIN)¶
A tax processing number for a person who needs a U.S. taxpayer identifier and cannot get an SSN. It uses the SSN hyphenation, starts with 9, and the fourth and fifth digits fall in the IRS ranges. A same-span SSN label is dropped.
| Package type | ITIN_US |
| Shape this package looks for | 9NN-NN-NNNN, middle digits 50β65, 70β88, 90β92, or 94β99 |
| Checksum | none |
| Example (synthetic) | 900-70-0000 |
Official sources
ATIN_US β Adoption Taxpayer Identification Number (ATIN)¶
A temporary IRS number for a child in a pending domestic adoption. It uses the SSN hyphenation, starts with 9, and the fourth and fifth digits are 93.
| Package type | ATIN_US |
| Shape this package looks for | 9NN-93-NNNN |
| Checksum | none |
| Example (synthetic) | 900-93-0000 |
Official sources
PTIN_US β Preparer Tax Identification Number (PTIN)¶
The identifier a paid tax return preparer puts on returns they prepare. The IRS describes it as the letter P followed by eight digits.
| Package type | PTIN_US |
| Shape this package looks for | P + 8 digits |
| Checksum | none |
| Example (synthetic) | P00000000 |
Official sources
MBI_US β Medicare Beneficiary Identifier (MBI)¶
The 11-character identifier CMS prints on Medicare cards. Characters 2, 5, 8, and 9 are letters. Letters S, L, O, I, B, and Z are excluded. Dashes on the card are optional in text.
| Package type | MBI_US |
| Shape this package looks for | 11 characters, CMS position classes, optional dashes as 4-3-4 |
| Checksum | none |
| Example (synthetic) | 1EG4-TE5-MK73 |
Official sources
A_NUMBER_US β Alien Registration Number¶
The DHS file number for a non-citizen. USCIS describes it as the letter A followed by 7, 8, or 9 digits. A shorter number is padded with zeros in current systems.
| Package type | A_NUMBER_US |
| Shape this package looks for | A, optional hyphen, 7β9 digits |
| Checksum | none |
| Example (synthetic) | A000000001 |
Official sources
USCIS_RECEIPT_US β USCIS receipt number¶
The 13-character identifier USCIS assigns to an application or petition: three letters and ten digits.
| Package type | USCIS_RECEIPT_US |
| Shape this package looks for | 3 letters + 10 digits |
| Checksum | none |
| Example (synthetic) | ABC0000000001 |
Official sources
DOS_CASE_US β Department of State immigrant case ID¶
The case id on an immigrant visa packet. USCIS describes the ordinary form as three letters and 9 or 10 digits, and a Diversity Visa case as four digits, two letters, and five digits. A same-span USCIS receipt wins.
| Package type | DOS_CASE_US |
| Shape this package looks for | 3 letters + 9 or 10 digits, or 4 digits + 2 letters + 5 digits |
| Checksum | none |
| Example (synthetic) | XYZ0123456789 |
Official sources
DEA_US β DEA registration number¶
The controlled-substance registration number: two letters and seven digits. The seventh digit is a check digit. A hospital may append a hyphen and an internal suffix under 21 CFR 1301.22(c). A same-span medical-licence label is dropped when the check passes.
| Package type | DEA_US |
| Shape this package looks for | 2 letters + 7 digits, optional hyphen and suffix |
| Checksum | DEA check digit. A failure is kept as DEA_US_LIKE. |
| Example (synthetic) | AB1234563 |
Official sources
The example values are synthetic or well-known public test numbers. Do not treat them as issued identifiers.