httpbin.org

HTTP request and response testing service

Version

0.9.2

OpenAPI

3.0.0

Endpoints

Schemas

62

Quality

Updated

3 days ago

Developer tools testing http developer-tools

Use this API in your AI agent

Query structured spec data via REST or MCP. Get exactly what your agent needs.

Get API Key

Server URLs

https://httpbin.org

Endpoints

GET POST PUT PATCH DELETE

Auth 6 endpoints

GET /basic-auth/{user}/{passwd} Prompts the user for authorization using HTTP Basic Auth.

operationId: Auth_promptAuthorizationUsingHttpGet

Parameters

Name	In	Required	Type	Description
user	path	required	string	—
passwd	path	required	string	—

Responses

200

Sucessful authentication.

401

Unsuccessful authentication.

GET /basic-auth/{user}/{passwd}

GET /bearer Prompts the user for authorization using bearer authentication.

operationId: Auth_promptAuthorization

Parameters

Name	In	Required	Type	Description
Authorization	header	optional	string	—

Responses

200

Sucessful authentication.

401

Unsuccessful authentication.

GET /bearer

GET /digest-auth/{qop}/{user}/{passwd} Prompts the user for authorization using Digest Auth.

operationId: Auth_digestAuthPrompt

Parameters

Name	In	Required	Type	Description
qop	path	required	string	auth or auth-int
user	path	required	string	—
passwd	path	required	string	—

Responses

200

Sucessful authentication.

401

Unsuccessful authentication.

GET /digest-auth/{qop}/{user}/{passwd}

GET /digest-auth/{qop}/{user}/{passwd}/{algorithm} Prompts the user for authorization using Digest Auth + Algorithm.

operationId: Auth_userAuthorizationDigest

Parameters

Name	In	Required	Type	Description
qop	path	required	string	auth or auth-int
user	path	required	string	—
passwd	path	required	string	—
algorithm	path	required	string	MD5, SHA-256, SHA-512

Responses

200

Sucessful authentication.

401

Unsuccessful authentication.

GET /digest-auth/{qop}/{user}/{passwd}/{algorithm}

GET /digest-auth/{qop}/{user}/{passwd}/{algorithm}/{stale_after} Prompts the user for authorization using Digest Auth + Algorithm.

allow settings the stale_after argument.

operationId: Auth_promptAuthorizationUsingDigest

Parameters

Name	In	Required	Type	Description
qop	path	required	string	auth or auth-int
user	path	required	string	—
passwd	path	required	string	—
algorithm	path	required	string	MD5, SHA-256, SHA-512
stale_after	path	required	string	—

Responses

200

Sucessful authentication.

401

Unsuccessful authentication.

GET /digest-auth/{qop}/{user}/{passwd}/{algorithm}/{stale_after}

GET /hidden-basic-auth/{user}/{passwd} Prompts the user for authorization using HTTP Basic Auth.

operationId: Auth_promptUserAuthorization

Parameters

Name	In	Required	Type	Description
user	path	required	string	—
passwd	path	required	string	—

Responses

200

Sucessful authentication.

404

Unsuccessful authentication.

GET /hidden-basic-auth/{user}/{passwd}

Cookies 4 endpoints

GET /cookies Returns cookie data.

operationId: Cookies_getData

Responses

200

Set cookies.

GET /cookies

GET /cookies/delete Deletes cookie(s) as provided by the query string and redirects to cookie list.

operationId: Cookies_deleteRedirectToCookieList

Parameters

Name	In	Required	Type	Description
freeform	query	optional	string	—

Responses

200

Redirect to cookie list

GET /cookies/delete

GET /cookies/set Sets cookie(s) as provided by the query string and redirects to cookie list.

operationId: Cookies_setRedirect

Parameters

Name	In	Required	Type	Description
freeform	query	optional	string	—

Responses

200

Redirect to cookie list

GET /cookies/set

GET /cookies/set/{name}/{value} Sets a cookie and redirects to cookie list.

operationId: Cookies_setCookieRedirect

Parameters

Name	In	Required	Type	Description
name	path	required	string	—
value	path	required	string	—

Responses

200

Set cookies and redirects to cookie list.

GET /cookies/set/{name}/{value}

Dynamicdata 13 endpoints

GET /base64/{value} Decodes base64url-encoded string.

operationId: DynamicData_decodeBase64urlString

Parameters

Name	In	Required	Type	Description
value	path	required	string	—

Responses

200

Decoded base64 content.

GET /base64/{value}

GET /bytes/{n} Returns n random bytes generated with given seed

operationId: DynamicData_getRandomBytes

Parameters

Name	In	Required	Type	Description
n	path	required	int	—

Responses

200

Bytes.

GET /bytes/{n}

DELETE /delay/{delay} Returns a delayed response (max of 10 seconds).

operationId: DynamicData_delayedResponseDelete

Parameters

Name	In	Required	Type	Description
delay	path	required	int	—

Responses

200

A delayed response.

DELETE /delay/{delay}

GET /delay/{delay} Returns a delayed response (max of 10 seconds).

operationId: DynamicData_delayedResponseGet

Parameters

Name	In	Required	Type	Description
delay	path	required	int	—

Responses

200

A delayed response.

GET /delay/{delay}

PATCH /delay/{delay} Returns a delayed response (max of 10 seconds).

operationId: DynamicData_returnDelayedResponse

Parameters

Name	In	Required	Type	Description
delay	path	required	int	—

Responses

200

A delayed response.

PATCH /delay/{delay}

POST /delay/{delay} Returns a delayed response (max of 10 seconds).

operationId: DynamicData_returnDelayedResponse

Parameters

Name	In	Required	Type	Description
delay	path	required	int	—

Responses

200

A delayed response.

POST /delay/{delay}

PUT /delay/{delay} Returns a delayed response (max of 10 seconds).

operationId: DynamicData_returnDelayedResponse

Parameters

Name	In	Required	Type	Description
delay	path	required	int	—

Responses

200

A delayed response.

PUT /delay/{delay}

GET /drip Drips data over a duration after an optional initial delay.

operationId: DynamicData_dripDataOverDuration

Parameters

Name	In	Required	Type	Description
duration	query	optional	number	The amount of time (in seconds) over which to drip each byte
numbytes	query	optional	integer	The number of bytes to respond with
code	query	optional	integer	The response code that will be returned
delay	query	optional	number	The amount of time (in seconds) to delay before responding

Responses

200

A dripped response.

GET /drip

GET /links/{n}/{offset} Generate a page containing n links to other pages which do the same.

operationId: DynamicData_generatePageContainingLinks

Parameters

Name	In	Required	Type	Description
n	path	required	int	—
offset	path	required	int	—

Responses

200

HTML links.

GET /links/{n}/{offset}

GET /range/{numbytes} Streams n random bytes generated with given seed, at given chunk size per packet.

operationId: DynamicData_streamRandomBytes

Parameters

Name	In	Required	Type	Description
numbytes	path	required	int	—

Responses

200

Bytes.

GET /range/{numbytes}

GET /stream-bytes/{n} Streams n random bytes generated with given seed, at given chunk size per packet.

operationId: DynamicData_streamRandomBytes

Parameters

Name	In	Required	Type	Description
n	path	required	int	—

Responses

200

Bytes.

GET /stream-bytes/{n}

GET /stream/{n} Stream n JSON responses

operationId: DynamicData_streamJsonResponses

Parameters

Name	In	Required	Type	Description
n	path	required	int	—

Responses

200

Streamed JSON responses.

GET /stream/{n}

GET /uuid Return a UUID4.

operationId: DynamicData_generateUuid

Responses

200

A UUID4.

GET /uuid

Redirects 7 endpoints

GET /absolute-redirect/{n} Absolutely 302 Redirects n times.

operationId: Redirects_absolutelyRedirectsN

Parameters

Name	In	Required	Type	Description
n	path	required	int	—

Responses

default

A redirection.

GET /absolute-redirect/{n}

DELETE /redirect-to 302/3XX Redirects to the given URL.

operationId: Redirects_toGivenUrlDelete

Responses

default

A redirection.

DELETE /redirect-to

GET /redirect-to 302/3XX Redirects to the given URL.

operationId: Redirects_toGivenUrlGet

Parameters

Name	In	Required	Type	Description
url	query	required	string	—
status_code	query	optional	int	—

Responses

default

A redirection.

GET /redirect-to

PATCH /redirect-to 302/3XX Redirects to the given URL.

operationId: Redirects_toGivenUrlPatch

Responses

default

A redirection.

PATCH /redirect-to

POST /redirect-to 302/3XX Redirects to the given URL.

operationId: Redirects_toGivenUrlPost

Request Body

application/x-www-form-urlencoded

schema RedirectsToGivenUrlPostRequest

Property	Type	Required
url	string	required
status_code	int	optional

Responses

default

A redirection.

POST /redirect-to

PUT /redirect-to 302/3XX Redirects to the given URL.

operationId: Redirects_givenUrlPutRedirect

Request Body

application/x-www-form-urlencoded

schema RedirectsToGivenUrlPostRequest

Property	Type	Required
url	string	required
status_code	int	optional

Responses

default

A redirection.

PUT /redirect-to

GET /redirect/{n} 302 Redirects n times.

operationId: Redirects_302RedirectsN

Parameters

Name	In	Required	Type	Description
n	path	required	int	—

Responses

default

A redirection.

GET /redirect/{n}

Load more endpoints

Schemas

object RedirectsToGivenUrlPostRequest

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string"
    },
    "status_code": {
      "type": "int"
    }
  }
}

Versions

Version	Endpoints	Schemas	Ingested	Status
0.9.2	73	1	2026-05-11	current
0.9.2	73	1	2026-04-16

httpbin.org

Server URLs

Endpoints

Anything 10 endpoints

Responses

Responses

Responses

Responses

Responses

Responses

Responses

Responses

Responses

Responses

Auth 6 endpoints

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Cookies 4 endpoints

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Dynamicdata 13 endpoints

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Parameters

Responses

Responses

Httpmethods 5 endpoints

Responses

Responses

Responses

Responses

Responses

Images 5 endpoints

Responses

Responses

Responses

Responses

Responses

Redirects 7 endpoints

Parameters

Responses

Responses

Parameters

Responses

Responses