ISBN Validation in Python — ISBN-10, ISBN-13 & Checksum

1. What is an ISBN?

ISBN stands for International Standard Book Number. It is a unique numeric identifier assigned to every edition of every commercially published book. Publishers, bookstores, libraries, and distributors use ISBNs to catalogue, order, and track books worldwide.

There are two formats in use today. ISBN-10 was the original standard, used from 1970 until 2007. ISBN-13 is the current standard, introduced on 1 January 2007. Every ISBN-13 starts with prefix 978 or 979.

ISBN-13 is a subset of the EAN-13 barcode system — the barcode printed on the back cover of a book is its ISBN-13 encoded as an EAN-13 barcode. The two numbers are identical.

2. ISBN anatomy

Both ISBN-10 and ISBN-13 are divided into groups separated by hyphens (or spaces). The hyphens are optional and carry no information — they exist purely for readability.

3. The check digit algorithms

ISBN-10 and ISBN-13 use completely different checksum algorithms. This is one of the main reasons you need a proper validator rather than a hand-written regex.

ISBN-10 — mod-11 with weights 10 down to 1

Let's walk through 0-306-40615-2:

ISBN-13 — mod-10 with alternating weights 1 and 3

Let's walk through 978-0-306-40615-7:

# isbn_checksum.py — validate ISBN-10 or ISBN-13 check digits
import re


def validate_isbn10(raw: str) -> bool:
    digits = re.sub(r"[-\s]", "", raw)
    if not re.match(r"^\d{9}[\dXx]$", digits):
        return False

    total = 0
    for i in range(9):
        total += int(digits[i]) * (10 - i)

    last = digits[9].upper()
    total += 10 if last == "X" else int(last)

    return total % 11 == 0


def validate_isbn13(raw: str) -> bool:
    digits = re.sub(r"[-\s]", "", raw)
    if not re.match(r"^\d{13}$", digits):
        return False

    total = sum(
        int(d) * (1 if i % 2 == 0 else 3)
        for i, d in enumerate(digits[:12])
    )

    check = (10 - (total % 10)) % 10
    return check == int(digits[12])


print(validate_isbn10("0-306-40615-2"))      # True   ISBN-10
print(validate_isbn13("978-0-306-40615-7"))  # True   ISBN-13
print(validate_isbn10("0-306-40615-3"))      # False  bad check digit

4. Why manual validation isn't enough

Writing ISBN validation from scratch seems simple at first glance, but there are several pitfalls that trip up hand-rolled implementations:

5. The right solution

The IsValid ISBN API handles all of this for you — format detection, checksum validation, and automatic ISBN-10/ISBN-13 conversion in a single call.

Full parameter reference and response schema: ISBN Validation API docs →

6. Python code example

from isvalid import create_client

iv = create_client(api_key=os.environ["ISVALID_API_KEY"])

# ── Example usage ────────────────────────────────────────────────────────────

result = iv.isbn("978-0-306-40615-7")

if not result["valid"]:
    print("Invalid ISBN")
else:
    print("Format:", result["format"])    # → 'ISBN-13'
    print("ISBN-10:", result["isbn10"])    # → '0306406152'
    print("ISBN-13:", result["isbn13"])    # → '9780306406157'

# Validate ISBNs before inserting into a book catalogue
def import_books(rows: list[dict]) -> list[dict]:
    results = []

    for row in rows:
        if not row.get("isbn"):
            results.append({**row, "isbn_status": "missing"})
            continue

        check = iv.isbn(row["isbn"])

        if not check["valid"]:
            results.append({**row, "isbn_status": "invalid"})
            continue

        results.append({
            **row,
            "isbn10": check["isbn10"],    # normalised ISBN-10 (or None for 979)
            "isbn13": check["isbn13"],    # normalised ISBN-13
            "isbn_format": check["format"],
            "isbn_status": "valid",
        })

    return results

7. cURL example

Validate an ISBN-13:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/isbn?value=9780306406157"

Validate an ISBN-10:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/isbn?value=0306406152"

With hyphens (URL-encoded automatically by most tools):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/isbn?value=978-0-306-40615-7"

Invalid ISBN (bad check digit):

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/isbn?value=978-0-306-40615-0"

8. Understanding the response

Valid ISBN-13 (978 prefix):

{
  "valid": true,
  "format": "ISBN-13",
  "isbn10": "0306406152",
  "isbn13": "9780306406157"
}

Valid ISBN-10:

{
  "valid": true,
  "format": "ISBN-10",
  "isbn10": "0306406152",
  "isbn13": "9780306406157"
}

ISBN-13 with 979 prefix (no ISBN-10 equivalent):

{
  "valid": true,
  "format": "ISBN-13",
  "isbn10": null,
  "isbn13": "9791234567896"
}

Invalid ISBN:

{
  "valid": false
}

9. Edge cases

# X check digit — perfectly valid
result = iv.isbn("0-8044-2957-X")
print(result["valid"])   # → True
print(result["format"])  # → 'ISBN-10'
print(result["isbn13"])  # → '9780804429573'

result = iv.isbn("979-12-345-6789-6")
print(result["isbn10"])  # → None
print(result["isbn13"])  # → '9791234567896'

10. Summary