---
id: httpbin
version: "0.10.4"
license: MIT or ISC
license_treatment: permissive
maintenance: active
---

# httpbin — HTTP Request and Response Service

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

## What it is and what it does

httpbin is a Flask-based service that exposes HTTP endpoints for testing and debugging HTTP clients. It was originally created by Kenneth Reitz and is now maintained as a fork by the Python community after the original became unmaintained. The package can be deployed as a standalone Docker container or used directly as a library in Python projects.

When used as a library, httpbin provides a Flask application object that can be integrated into test suites or development environments. It includes endpoints for testing various HTTP scenarios: response codes, redirects, delays, byte streams, digest authentication, and more. The package depends on Flask, werkzeug, greenlet, decorator, brotlicffi, six, and importlib-metadata. Recent releases have made flasgger optional and fixed Python 3.12+ compatibility issues.

Use it for:

- Test HTTP client libraries like requests by making real HTTP calls to a local or remote httpbin instance.
- Debug HTTP request/response behavior during development without needing a real backend service.
- Verify authentication flows (digest auth, basic auth) in HTTP clients before integration.
- Simulate network conditions like delays, redirects, and byte streaming for stress testing.
- Validate error handling by requesting specific HTTP status codes and response formats.

## Worth the install?

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

httpbin is a Flask-based HTTP request and response service that provides endpoints for testing and debugging HTTP clients and libraries.

Yes. httpbin is actively maintained, has no known vulnerabilities, and is widely used in the Python ecosystem (pytest-httpbin, requests). Install friction is low and it supports current Python versions (3.8–3.14). Use it as a library for HTTP client testing or deploy the Docker image as a standalone service.

## Install

pip install httpbin
uv add httpbin
poetry add httpbin

## Installing httpbin

Before you install: Low install friction with a wheel distribution and seven runtime dependencies. Actively maintained as of 2026-06-16 with recent fixes for Python 3.12+ compatibility and dependency cleanup.

License in practice: Dual-licensed under MIT or ISC (both permissive). No restrictions on commercial or private use.

Quickstart:

pip install httpbin

from httpbin import app
from flask import Flask

# Use the Flask app directly in tests or as a WSGI application
if __name__ == '__main__':
    app.run()

Requires Python 3.8 or later. The Flask framework and its dependencies (werkzeug, greenlet) must be available.

Verify before relying:

- Whether the package is intended primarily as a library dependency or as a standalone service to be run separately.
- What specific HTTP testing scenarios each endpoint (/bytes, /delay, /redirect-to, /drip, etc.) is designed to cover.
- Performance characteristics or concurrency limits when used as a library in test suites.

## Package facts

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

## Tags

http request testing service, mock http server, http client testing, debug http requests, http endpoint simulator, request response testing, http test harness, http-testing, mock-server, flask-app

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