Verify if a Variable is an Integer in Python

During my ten years of developing Python applications for financial firms in New York, I have often faced a recurring challenge.

I frequently need to verify if a data input, like a ZIP code or a Social Security Number fragment, is actually an integer before processing it.

If you don’t validate these variable types, your Python scripts can crash or produce messy data errors during runtime.

In this tutorial, I will show you exactly how to check if a Python variable contains an integer using the most efficient methods I’ve used in production.

Check for Integers in Python

In a dynamic language like Python, variables can change types quickly, which often leads to unexpected bugs.

For example, when calculating the total cost of a shipment from a warehouse in Chicago to Los Angeles, a “quantity” variable must be a whole number.

If that variable accidentally becomes a string or a float, your mathematical operations might fail or return nonsensical results.

1. Use the Python isinstance() Function (The Best Way)

In my experience, the isinstance() function is the most reliable and “Pythonic” way to check for an integer.

I prefer this method because it handles inheritance correctly, making it the industry standard for type checking.

Python Code Example: Validate US Census Data

Imagine you are processing census data and need to ensure the “Household Size” variable is an integer.

# Defining a variable for household size in a Dallas suburb
household_size = 4

# Using isinstance to verify if it is an integer
if isinstance(household_size, int):
    print(f"Success: {household_size} is a valid integer for Python processing.")
else:
    print("Error: The household size must be a whole number.")

You can refer to the screenshot below to see the output.

When you run this Python code, it returns “Success” because 4 is an integer.

2. The Python type() Function Approach

Another common way I see developers check types is by using the built-in type() function.

While this works for simple scripts, it is generally less flexible than isinstance() because it does not account for subclasses.

Python Code Example: Check a California Sales Tax ID

Suppose you are verifying a Sales Tax ID number for a business in San Francisco.

# Business tax ID variable
tax_id = 94105123

# Comparing the type directly
if type(tax_id) == int:
    print("This Python variable is strictly an integer.")
else:
    print("The variable type does not match.")

You can refer to the screenshot below to see the output.

I usually avoid this in large-scale Python projects because it is “brittle.” If you ever use custom integer-like classes, this check will fail.

3. Check if a Python Float is Actually an Integer

In many US-based financial apps, currency is handled as a float, but sometimes you need to know if the value is a whole number (like $100.00).

Python provides the is_integer() method specifically for float objects to help with this.

Python Code Example: Check USD Currency Values

If a user enters a donation amount for a charity in Seattle, you might want to see if they gave a round dollar amount.

# Donation amount in USD
donation = 500.0

# Using is_integer on a float variable
if isinstance(donation, float) and donation.is_integer():
    print("The donation is a whole dollar amount.")
else:
    print("The donation includes cents or is not a float.")

You can refer to the screenshot below to see the output.

Note that this method only exists on the float class in Python, so I always check if the variable is a float first to avoid an AttributeError.

4. Use the str.isdigit() Method for String Inputs

Frequently, data comes into your Python script as a string, especially when reading from an Excel file or a web form.

When I process ZIP codes from a mailing list in Miami, the numbers often arrive wrapped in quotes (e.g., “33101”).

Python Code Example: Validating a Florida ZIP Code

You can use the .isdigit() method to check if a string contains only numeric characters.

# ZIP code received as a string input
zip_code = "33101"

# Checking if the string can be converted to an integer
if zip_code.isdigit():
    converted_zip = int(zip_code)
    print(f"The ZIP code {converted_zip}https://pythonguides.com/create-web-form-in-python-django/ is now a Python integer.")
else:
    print("Invalid ZIP code format.")

You can refer to the screenshot below to see the output.

This is a lifesaver when cleaning data in Python, but remember it won’t work for negative numbers (like -10) because the minus sign is not a digit.

5. Leverage the Python Try-Except Block (The Easiest Way)

When I’m not sure what the input format will be, I often use a “Try-Except” block, which follows the “it’s easier to ask for forgiveness than permission” philosophy.

This method is incredibly robust because it attempts to force the variable into an integer and catches the error if it fails.

Python Code Example: Process an Age Input

Let’s say a user in Boston is filling out a form and enters their age.

# Input received from a web form
user_age_input = "25"

try:
    # Attempting to convert the Python variable
    age = int(user_age_input)
    print(f"Validation passed. User age is {age}.")
except ValueError:
    print("Validation failed. Please enter a numeric value for age.")

This is my favorite approach for Python user-input validation because it handles various edge cases gracefully.

How to Check if a Variable is an Integer Using Math

Sometimes, you might want to use a mathematical approach to verify an integer, especially if you are working with the math module.

In Python, the modulo operator % can tell you if a number has a remainder when divided by one.

Python Code Example: Inventory Count in a Chicago Warehouse

If you are counting pallets in a warehouse, the count must be an integer.

# Inventory count variable
pallet_count = 12.0

# If the remainder of division by 1 is 0, it's an integer
if pallet_count % 1 == 0:
    print("The inventory count is a whole number.")
else:
    print("Error: We cannot have partial pallets.")

I find this useful when I’m already doing heavy math in a Python script and want a quick, inline check.

Summary of Python Integer Checking Methods

To help you choose the right tool for your project, I’ve summarized the methods I use most often in the table below.

In this tutorial, I have covered several ways to check if a variable is an integer in Python.

The method you choose usually depends on whether you are dealing with raw user input, float values, or strict object types. I hope this helps you write cleaner, more stable Python code for your next project!

If you found this guide helpful, you might also want to explore my other Python tutorials on data validation and error handling.

You may also like to read:

• Python Except KeyError
• Catch Multiple Exceptions in Python
• Complex Numbers in Python
• Add Complex Numbers in Python

Bijay Kumar

I am Bijay Kumar, a Microsoft MVP in SharePoint. Apart from SharePoint, I started working on Python, Machine learning, and artificial intelligence for the last 5 years. During this time I got expertise in various Python libraries also like Tkinter, Pandas, NumPy, Turtle, Django, Matplotlib, Tensorflow, Scipy, Scikit-Learn, etc… for various clients in the United States, Canada, the United Kingdom, Australia, New Zealand, etc. Check out my profile.

enjoysharepoint.com/