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'
Traceback (most recent call last):
    ...
InvalidComponent: ...

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 passed number to the standard format.

stdnum.us.itin.is_valid(number)

Checks to see if the number provided is a valid ITIN. This checks the length, groups and formatting if it is present.

stdnum.us.itin.validate(number)

Checks to see if the number provided is a valid ITIN. This checks the length, groups and formatting if it is present.