faker.providers.ssn.en_US

Package Contents

Classes

BaseProvider

Provider

class faker.providers.ssn.en_US.BaseProvider(generator: Any)

Bases: faker.providers.BaseProvider

ssn_formats: faker.providers.ElementsType[str] = ('###-##-####',)
ssn() str
class faker.providers.ssn.en_US.Provider(generator: Any)

Bases: faker.providers.ssn.Provider

INVALID_SSN_TYPE = 'INVALID_SSN'
SSN_TYPE = 'SSN'
ITIN_TYPE = 'ITIN'
EIN_TYPE = 'EIN'
itin() str

Generate a random United States Individual Taxpayer Identification Number (ITIN).

An United States Individual Taxpayer Identification Number (ITIN) is a tax processing number issued by the Internal Revenue Service. It is a nine-digit number that always begins with the number 9 and has a range of 70-88 in the fourth and fifth digit. Effective April 12, 2011, the range was extended to include 900-70-0000 through 999-88-9999, 900-90-0000 through 999-92-9999 and 900-94-0000 through 999-99-9999. https://www.irs.gov/individuals/international-taxpayers/general-itin-information

ein() str

Generate a random United States Employer Identification Number (EIN).

An United States An Employer Identification Number (EIN) is also known as a Federal Tax Identification Number, and is used to identify a business entity. EINs follow a format of a two-digit prefix followed by a hyphen and a seven-digit sequence: ##-######

https://www.irs.gov/businesses/small-businesses-self-employed/employer-id-numbers

invalid_ssn() str

Generate a random invalid United States Social Security Identification Number (SSN).

Invalid SSNs have the following characteristics: Cannot begin with the number 9 Cannot begin with 666 in positions 1 - 3 Cannot begin with 000 in positions 1 - 3 Cannot contain 00 in positions 4 - 5 Cannot contain 0000 in positions 6 - 9

https://www.ssa.gov/kc/SSAFactSheet–IssuingSSNs.pdf

Additionally, return an invalid SSN that is NOT a valid ITIN by excluding certain ITIN related “group” values

ssn(taxpayer_identification_number_type: str = SSN_TYPE) str

Generate a random United States Taxpayer Identification Number of the specified type.

If no type is specified, a US SSN is returned.