Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

HTTP Request and Response Service

Project Description
httpbin(1): HTTP Request & Response Service

Freely hosted in `HTTP <>`__,
`HTTPS <>`__ & `EU <>`__
flavors by `Runscope <>`__


.. |Deploy| image::
.. _Deploy:

|Build Status|


====================================== ==================================================================================================================
Endpoint Description
-------------------------------------- ------------------------------------------------------------------------------------------------------------------
`/`_ This page.
`/ip`_ Returns Origin IP.
`/user-agent`_ Returns user-agent.
`/headers`_ Returns header dict.
`/get`_ Returns GET data.
`/post` Returns POST data.
`/patch` Returns PATCH data.
`/put` Returns PUT data.
`/delete` Returns DELETE data
`/gzip`_ Returns gzip-encoded data.
`/deflate`_ Returns deflate-encoded data.
`/status/:code`_ Returns given HTTP Status code.
`/response-headers`_ Returns given response headers.
`/redirect/:n`_ 302 Redirects *n* times.
`/redirect-to?url=foo`_ 302 Redirects to the *foo* URL.
`/redirect-to?url=foo&status_code=307`_ 307 Redirects to the *foo* URL.
`/relative-redirect/:n`_ 302 Relative redirects *n* times.
`/cookies`_ Returns cookie data.
`/cookies/set?name=value`_ Sets one or more simple cookies.
`/cookies/delete?name`_ Deletes one or more simple cookies.
`/basic-auth/:user/:passwd`_ Challenges HTTPBasic Auth.
`/hidden-basic-auth/:user/:passwd`_ 404'd BasicAuth.
`/digest-auth/:qop/:user/:passwd`_ Challenges HTTP Digest Auth.
`/stream/:n`_ Streams *n* – 100 lines.
`/delay/:n`_ Delays responding for *n* – 10 seconds.
`/drip`_ Drips up to 10MB data over a duration after an optional initial delay, then (optionally) returns with the given status code.
`/range/:n`_ Streams *n* bytes, and allows specifying a *Range* header to select a subset of the data. Accepts a *chunk\_size* and request *duration* parameter.
`/html`_ Renders an HTML Page.
`/robots.txt`_ Returns some robots.txt rules.
`/deny`_ Denied by robots.txt file.
`/cache`_ Returns 200 unless an If-Modified-Since or If-None-Match header is provided, when it returns a 304.
`/cache/:n`_ Sets a Cache-Control header for *n* seconds.
`/bytes/:n`_ Generates *n* random bytes of binary data, accepts optional *seed* integer parameter.
`/stream-bytes/:n`_ Streams *n* random bytes of binary data, accepts optional *seed* and *chunk\_size* integer parameters.
`/links/:n`_ Returns page containing *n* HTML links.
`/forms/post`_ HTML form that submits to */post*
`/xml`_ Returns some XML
`/encoding/utf8`_ Returns page containing UTF-8 data.
====================================== ==================================================================================================================

.. _/user-agent:
.. _/headers:
.. _/get:
.. _/:
.. _/ip:
.. _/gzip:
.. _/deflate:
.. _/status/:code:
.. _/response-headers:;%20charset=UTF-8&Server=httpbin
.. _/redirect/:n:
.. _/redirect-to?url=foo:
.. _/redirect-to?url=foo&status_code=307:
.. _/relative-redirect/:n:
.. _/cookies:
.. _/cookies/set?name=value:
.. _/cookies/delete?name:
.. _/basic-auth/:user/:passwd:
.. _/hidden-basic-auth/:user/:passwd:
.. _/digest-auth/:qop/:user/:passwd:
.. _/stream/:n:
.. _/delay/:n:
.. _/drip:
.. _/range/:n:
.. _/html:
.. _/robots.txt:
.. _/deny:
.. _/cache:
.. _/cache/:n:
.. _/bytes/:n:
.. _/stream-bytes/:n:
.. _/links/:n:
.. _/forms/post:
.. _/xml:
.. _/encoding/utf8:


Testing an HTTP Library can become difficult sometimes.
`RequestBin <>`__ is fantastic for testing POST
requests, but doesn't let you control the response. This exists to cover
all kinds of HTTP scenarios. Additional endpoints are being considered.

All endpoint responses are JSON-encoded.


$ curl


{"origin": ""}

$ curl


{"user-agent": "curl/7.19.7 (universal-apple-darwin10.0) libcurl/7.19.7 OpenSSL/0.9.8l zlib/1.2.3"}

$ curl


"args": {},
"headers": {
"Accept": "*/*",
"Connection": "close",
"Content-Length": "",
"Content-Type": "",
"Host": "",
"User-Agent": "curl/7.19.7 (universal-apple-darwin10.0) libcurl/7.19.7 OpenSSL/0.9.8l zlib/1.2.3"
"origin": "",
"url": ""

$ curl -I


Server: nginx/0.7.67
Date: Mon, 13 Jun 2011 04:25:38 GMT
Connection: close
Content-Length: 135

$ curl\_env=1


"headers": {
"Content-Length": "",
"Accept-Language": "en-US,en;q=0.8",
"Accept-Encoding": "gzip,deflate,sdch",
"X-Forwarded-Port": "443",
"X-Forwarded-For": "",
"Host": "",
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
"User-Agent": "Mozilla/5.0 (X11; Linux i686) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.83 Safari/535.11",
"X-Request-Start": "1350053933441",
"Accept-Charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.3",
"Connection": "keep-alive",
"X-Forwarded-Proto": "https",
"Cookie": "_gauges_unique_day=1; _gauges_unique_month=1; _gauges_unique_year=1; _gauges_unique=1; _gauges_unique_hour=1",
"Content-Type": ""
"args": {
"show_env": "1"
"origin": "",
"url": ""

Installing and running from PyPI

You can install httpbin as a library from PyPI and run it as a WSGI app.
For example, using Gunicorn:

.. code:: bash

$ pip install httpbin
$ gunicorn httpbin:app

Or install and run it directly:

.. code:: bash

$ git clone
$ pip install -e httpbin
$ python -m httpbin.core [--port=PORT] [--host=HOST]


- 0.5.0:
- Allow /redirect-to to work with multiple methods
- Allow MD5 or SHA-256 to be chosen as algorithms for HTTP Digest Auth
- Set a 10MB limit on /drip
- 0.4.1: Added floating-point support for /delay endpoint
- 0.4.0: New /image/svg endpoint, add deploy to heroku button, add 406 response to /image, and don't always emit the transfer-encoding header for stream endpoint.
- 0.3.0: A number of new features, including a /range endpoint, lots of
bugfixes, and a /encoding/utf8 endpoint
- 0.2.0: Added an XML endpoint. Also fixes several bugs with unicode,
CORS headers, digest auth, and more.
- 0.1.2: Fix a couple Python3 bugs with the random byte endpoints, fix
a bug when uploading files without a Content-Type header set.
- 0.1.1: Added templates as data in
- 0.1.0: Added python3 support and (re)publish on PyPI


A `Runscope Community Project <>`__.
Originally created by `Kenneth Reitz <>`__.



.. |Build Status| image::

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
httpbin-0.5.0-py2.py3-none-any.whl (92.1 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Aug 15, 2016
httpbin-0.5.0.tar.gz (88.7 kB) Copy SHA256 Checksum SHA256 Source Aug 15, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting