---
id: types-maxminddb
version: "1.5.0"
license: Apache-2.0 license
license_treatment: permissive
maintenance: active
---

# types-maxminddb — Typing stubs for maxminddb

License: permissive · Maintenance: active · Downloads: 587.6K/mo

## What it is and what it does

types-maxminddb is a PEP 561 type stub package that provides type information for the maxminddb library. It allows static type checkers like mypy, PyCharm, and pytype to understand and validate the types of maxminddb's API, catching type errors at development time rather than runtime.

The package is maintained as part of typeshed. The description notes that maxminddb has shipped its own type annotations since version 2.0.2, so installing this stub package may be unnecessary if you are already using that version or later of maxminddb itself.

Use it for:

- Enable type checkers to validate code that calls maxminddb functions for IP geolocation queries.
- Provide IDE autocomplete and type hints when working with maxminddb APIs.
- Catch type mismatches in geolocation lookup code before runtime in CI/CD pipelines.
- Support maxminddb versions that lack built-in type annotations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type stubs for the maxminddb package, enabling static type checkers like mypy and PyCharm to validate code using maxminddb.

Yes, if you are using maxminddb versions before 2.0.2 and rely on static type checking. No, if you are already on maxminddb 2.0.2 or later, since maxminddb itself now includes type annotations. Check your maxminddb version first to avoid redundant installation.

## Install

pip install types-maxminddb
uv add types-maxminddb
poetry add types-maxminddb

## Installing types-maxminddb

Before you install: Low install friction with a single lightweight runtime dependency (types-ipaddress). The package is actively maintained via typeshed, though the latest release is from 2021-09-20.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in most commercial and open-source projects without significant restriction.

Quickstart:

pip install types-maxminddb

import maxminddb
# Type checker now understands maxminddb API types

Verify before relying:

- Whether maxminddb version 2.0.2 or later is already installed (stub package may be unnecessary in that case)
- Current maintenance status relative to typeshed's active development cycle

## Package facts

- License: Apache-2.0 license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 587.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

type stubs maxminddb, mypy type checking maxminddb, pep 561 type stubs, maxminddb typing support, static type hints geolocation, type annotations geoip, type-stubs, typing-support

[View on SkillFed](https://skillfed.io/packages/types-maxminddb) · [View on PyPI](https://pypi.org/project/types-maxminddb/)