types-requests

Typing stubs for requests

types-requests Permissive license Apache-2.0 Active ★ 37 v2.33.0.20260712 released 2026-07-12

Install

types-requests on PyPI

pip

pip install types-requests

uv

uv add types-requests

poetry

poetry add types-requests

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — urllib3
Maintenance	actively maintained — 32 days since the last release
Last repo commit	2026-08-13
First released	2021-02-02
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: types_requests-2.33.0.20260712-py3-none-any.whl

Programming Language :: Python :: 3Typing :: Stubs Only

About types-requests

from the package's own PyPI description — quoted content, verbatim

Typing stubs for requests

This is a type stub package for the requests package. It can be used by type checkers to check code that uses requests. This version of types-requests aims to provide accurate annotations for requests~=2.33.0.

Note: types-requests has required urllib3>=2 since v2.31.0.7. If you need to install types-requests into an environment that must also have urllib3<2 installed into it, you will have to use types-requests<2.31.0.7.

Note: The requests package includes type annotations or type stubs since version 2.34.0. Please uninstall the types-requests package if you use this or a newer version.

This package is part of the typeshed project. All fixes for types and metadata should be contributed there. See the README for more details. The source for this package can be found in the stubs/requests directory.

This package was tested with the following type checkers: *...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides type stubs for the requests library, enabling static type checkers like mypy and pyright to validate code that uses requests without runtime overhead.

Low friction; single runtime dependency on urllib3 and actively maintained with releases tracked to typeshed. Last release 32 days ago signals ongoing upkeep.

Apache-2.0 permissive license allows use in most commercial and open-source projects without significant restrictions.

Usage

pip install types-requests

Use with type checkers like mypy or pyright to validate code using the requests package.

Requires Python >=3.10. Requires urllib3>=2 since v2.31.0.7.

Verdict: A well-maintained type stub package backed by typeshed and tested against mypy 2.2.0 and pyright 1.1.411. No known vulnerabilities. Note that requests includes type annotations since version 2.34.0, making types-requests unnecessary for those versions.

Needs verification

Whether urllib3>=2 requirement creates compatibility issues in projects pinned to urllib3<2
Adoption patterns for types-requests relative to native requests annotations in 2.34.0+

type stubs for requestsrequests type annotationsmypy requests typingstatic type checking httprequests type hintspyright stubstype checker support