httpbin.org

A simple HTTP Request & Response Service.

Run locally: $ docker run -p 80:80 kennethreitz/httpbin

Claim this API

Are you the operator of httpbin.org? Submit a claim to establish contact with us.

Report an Issue

Found something wrong with httpbin.org? Let us know about broken links, changed auth, deprecated endpoints, or other issues.

Screenshot:
Screenshot of httpbin.org homepage
Base URL: https://httpbin.org
Auth: none
Endpoints: 42
Reachable: unknown
CORS: unknown

Links

Homepage: https://kennethreitz.org
API Base: https://httpbin.org

Topics

DEVTOOLS

Endpoints

Method Path Summary Auth Last Status Latency
GET /absolute-redirect/{n} Absolutely 302 Redirects n times.
GET /anything Returns anything passed in request data.
TRACE /anything Returns anything passed in request data.
GET /anything/{anything} Returns anything passed in request data.
TRACE /anything/{anything} Returns anything passed in request data.
GET /base64/{value} Decodes base64url-encoded string.
GET /brotli Returns Brotli-encoded data.
GET /bytes/{n} Returns n random bytes generated with given seed
GET /cache Returns a 304 if an If-Modified-Since header or If-None-Match is present. Returns the same as a GET otherwise.
GET /cache/{value} Sets a Cache-Control header for n seconds.
GET /cookies Returns cookie data.
GET /cookies/delete Deletes cookie(s) as provided by the query string and redirects to cookie list.
GET /cookies/set Sets cookie(s) as provided by the query string and redirects to cookie list.
GET /cookies/set/{name}/{value} Sets a cookie and redirects to cookie list.
GET /deflate Returns Deflate-encoded data.
GET /delay/{delay} Returns a delayed response (max of 10 seconds).
TRACE /delay/{delay} Returns a delayed response (max of 10 seconds).
GET /deny Returns page denied by robots.txt rules.
GET /drip Drips data over a duration after an optional initial delay.
GET /encoding/utf8 Returns a UTF-8 encoded body.
GET /etag/{etag} Assumes the resource has the given etag and responds to If-None-Match and If-Match headers appropriately.
GET /get The request's query parameters.
GET /gzip Returns GZip-encoded data.
GET /headers Return the incoming request's HTTP headers.
GET /html Returns a simple HTML document.
GET /image Returns a simple image of the type suggest by the Accept header.
GET /image/jpeg Returns a simple JPEG image.
GET /image/png Returns a simple PNG image.
GET /image/svg Returns a simple SVG image.
GET /image/webp Returns a simple WEBP image.
GET /ip Returns the requester's IP Address.
GET /json Returns a simple JSON document.
GET /links/{n}/{offset} Generate a page containing n links to other pages which do the same.
GET /range/{numbytes} Streams n random bytes generated with given seed, at given chunk size per packet.
GET /redirect-to 302/3XX Redirects to the given URL.
TRACE /redirect-to 302/3XX Redirects to the given URL.
GET /redirect/{n} 302 Redirects n times.
GET /relative-redirect/{n} Relatively 302 Redirects n times.
GET /response-headers Returns a set of response headers from the query string.
GET /robots.txt Returns some robots.txt rules.
GET /status/{codes} Return status code or random status code if more than one are given
TRACE /status/{codes} Return status code or random status code if more than one are given
GET /stream-bytes/{n} Streams n random bytes generated with given seed, at given chunk size per packet.
GET /stream/{n} Stream n JSON responses
GET /user-agent Return the incoming requests's User-Agent header.
GET /uuid Return a UUID4.
GET /xml Returns a simple XML document.