---
id: types-ldap3
version: "2.9.13.20260518"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-ldap3 — Typing stubs for ldap3

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

## What it is and what it does

types-ldap3 is a type stub package from the typeshed project that provides type annotations for the ldap3 library. It allows static type checkers like mypy and pyright to understand and validate code that uses ldap3 for LDAP directory operations, catching type errors before runtime.

The package is a pure-Python stub-only distribution with no runtime code. It targets ldap3 version 2.9.* and has been tested with mypy 2.1.0 and pyright 1.1.409. Installation is lightweight, requiring only types-pyasn1 as a runtime dependency. It is actively maintained through the typeshed project and receives regular updates.

Use it for:

- Enable mypy or pyright to type-check code that queries LDAP directories via ldap3
- Catch type mismatches in ldap3 connection parameters and search filters before deployment
- Support IDE autocomplete and inline type hints for ldap3 API calls
- Validate LDAP authentication and directory binding code in type-strict projects

## Worth the install?

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

Provides type stubs for the ldap3 package, enabling static type checkers like mypy and pyright to validate code that uses ldap3 for LDAP directory operations.

Yes, if you use ldap3 and run static type checking. Install it alongside ldap3 to get type validation and IDE support. It has no runtime overhead, low friction, and is actively maintained. If you do not use a type checker or do not use ldap3, it provides no value.

## Install

pip install types-ldap3
uv add types-ldap3
poetry add types-ldap3

## Installing types-ldap3

Before you install: Low install friction; a pure-Python stub package with minimal dependencies (only types-pyasn1). Actively maintained as part of typeshed, with recent releases and no known vulnerabilities.

License in practice: Apache-2.0 permissive license allows use in most projects without restriction, including commercial and proprietary software.

Quickstart:

pip install types-ldap3

# In your Python code with mypy or pyright enabled:
import ldap3
conn: ldap3.Connection = ldap3.Server('ldap://example.com')

Requires Python 3.10 or later; only provides type information, does not replace the ldap3 package itself.

Verify before relying:

- Whether type coverage is complete for all ldap3 2.9.* APIs or if gaps remain
- Compatibility with ldap3 versions outside the 2.9.* range

## Package facts

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

## Tags

ldap3 type stubs, type checking ldap3, mypy ldap3 annotations, pyright ldap directory, ldap3 type hints, static type checking ldap, typeshed ldap stubs, type-stubs, ldap, typeshed

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