# stdnum.in_.pan

PAN (Permanent Account Number, Indian income tax identifier).

The Permanent Account Number (PAN) is a 10 digit alphanumeric identifier for Indian individuals, families and corporates for income tax purposes. It is also issued to foreign nationals subject to a valid visa.

PAN is made up of 5 letters, 4 digits and 1 alphabetic check digit. The 4th character indicates the type of holder, the 5th character is either 1st letter of the holder’s name or holder’s surname in case of ‘Individual’ PAN, next 4 digits are serial numbers running from 0001 to 9999 and the last character is a check digit computed by an undocumented checksum algorithm.

More information:

- https://en.wikipedia.org/wiki/Permanent_account_number

- https://incometaxindia.gov.in/tutorials/1.permanent%20account%20number%20(pan).pdf

    >>> validate('ACUPA7085R')
    'ACUPA7085R'
    >>> validate('ACUPA7085RR')
    Traceback (most recent call last):
        ...
    InvalidLength: ...
    >>> validate('ABMPA32111')  # check digit should be a letter
    Traceback (most recent call last):
        ...
    InvalidFormat: ...
    >>> validate('ABMXA3211G')  # invalid type of holder
    Traceback (most recent call last):
        ...
    InvalidComponent: ...
    >>> validate('ACUPA0000R')  # serial number should not be '0000'
    Traceback (most recent call last):
        ...
    InvalidComponent: ...
    >>> mask('AAPPV8261K')
    'AAPPVXXXXK'
    >>> info('AAPPV8261K')['holder_type']
    'Individual'

stdnum.in_.pan.compact(number: str) → str

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

stdnum.in_.pan.info(number: str) → dict[str, str]

  Provide information that can be decoded from the PAN.

stdnum.in_.pan.is_valid(number: str) → bool

  Check if the number provided is a valid PAN. This checks the length and formatting.

stdnum.in_.pan.mask(number: str) → str

  Mask the PAN as per Central Board of Direct Taxes (CBDT) masking standard.

stdnum.in_.pan.validate(number: str) → str

  Check if the number provided is a valid PAN. This checks the length and formatting.