Public | Automated Build

Last pushed: a year ago
Short Description
httpbin(1): HTTP Request & Response Service
Full Description

httpbin(1): HTTP Request & Response Service

Freely hosted in HTTP <>,
HTTP/2 <> & 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]


Docker Hub: jihchi/httpbin <>__

.. code:: bash

$ docker run -p 8000:8000 jihchi/httpbin


  • 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::

Docker Pull Command
Source Repository