# stdnum.us.tin

TIN (U.S. Taxpayer Identification Number).

The Taxpayer Identification Number is used used for tax purposes in the United States. A TIN may be:

- a Social Security Number (SSN)

- an Individual Taxpayer Identification Number (ITIN)

- an Employer Identification Number (EIN)

- a Preparer Tax Identification Number (PTIN)

- an Adoption Taxpayer Identification Number (ATIN)

    >>> compact('123-45-6789')
    '123456789'
    >>> validate('123-45-6789')
    '123456789'
    >>> validate('07-3456789')
    Traceback (most recent call last):
        ...
    InvalidFormat: ...
    >>> guess_type('536-90-4399')
    ['ssn', 'atin']
    >>> guess_type('04-2103594')
    ['ein']
    >>> guess_type('042103594')
    ['ssn', 'ein', 'atin']
    >>> format('042103594')
    '042-10-3594'
    >>> format('123-456')  # invalid numbers are not reformatted
    '123-456'

stdnum.us.tin.compact(number)

  Convert the number to the minimal representation. This strips the number of any valid separators and removes surrounding whitespace.

stdnum.us.tin.format(number)

  Reformat the number to the standard presentation format.

stdnum.us.tin.guess_type(number)

  Return a list of possible TIN types for which this number is valid..

stdnum.us.tin.is_valid(number)

  Check if the number is a valid TIN.

stdnum.us.tin.validate(number)

  Check if the number is a valid TIN. This searches for the proper sub-type and validates using that.