stdnum.us.itin

ITIN (U.S. Individual Taxpayer Identification Number).

The Individual Taxpayer Identification Number is issued by the United States IRS to individuals who are required to have a taxpayer identification number but who are not eligible to obtain a Social Security Number.

It is a nine-digit number that begins with the number 9 and the fourth and fifth digit are expected to be in a certain range.

>>> validate('912-90-3456')
'912903456'
>>> validate('9129-03456')  # dash in the wrong place
Traceback (most recent call last):
    ...
InvalidFormat: ...
>>> validate('123-45-6789')  # wrong start digit
Traceback (most recent call last):
    ...
InvalidComponent: ...
>>> validate('912-93-4567')  # wrong group
Traceback (most recent call last):
    ...
InvalidComponent: ...
>>> compact('1234-56-789')
'123456789'
>>> format('111223333')
'111-22-3333'
>>> format('123')  # unknown formatting is left alone
'123'

stdnum.us.itin.compact(number)

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

stdnum.us.itin.format(number)

Reformat the number to the standard presentation format.

stdnum.us.itin.is_valid(number)

Check if the number is a valid ITIN.

stdnum.us.itin.validate(number)

Check if the number is a valid ITIN. This checks the length, groups and formatting if it is present.