HTTPie (pronounced aitch-tee-tee-pie) is a command-line HTTP client. Its goal is to make CLI interaction with web services as human-friendly as possible. HTTPie is designed for testing, debugging, and generally interacting with APIs & HTTP servers. The http & https commands allow for creating and sending arbitrary HTTP requests. They use simple and natural syntax and provide formatted and colorized output.

Please note we recently accidentally made this repo private for a moment, and GitHub deleted our community that took a decade to build. Read the full story here: https://httpie.io/blog/stardust

• Installation instructions →
• Full documentation →
• For a brief tutorial on getting started, see the Quick start guide

• Expressive and intuitive syntax
• Formatted and colorized terminal output
• Built-in JSON support
• Forms and file uploads
• HTTPS, proxies, and authentication
• Arbitrary request data
• Custom headers
• Persistent sessions
• wget-like downloads

See all features →

Before Using HTTPie, you must install it. HTTPie works on Windows, macOS, and Linux. You can install using pip:

pip install httpie

See full Installation instructions → for more other options.

Once HTTPie is installed, you can make requests immediately.

http httpbin.org/get

This command will send a GET request to httpbin.org, a website for testing HTTP requests. You will see the response from the server in your terminal.

To send data with a POST request, use the following:

http POST httpbin.org/post hello=world

This will send a POST request with the data 'hello=world' to httpbin.org. The server's response will include details.

If you want to see the data sent in the HTTP request, use the '--verbose' or '-v' flag:

http --verbose httpbin.org/get

Those are the basics of using HTTPie. For more information, see the Full documentation →

Hello World:

https httpie.io/hello

Custom HTTP method, HTTP headers and JSON data:

http PUT pie.dev/put X-API-Token:123 name=John

Build and print a request without sending it using offline mode:

http --offline pie.dev/post hello=offline

Use GitHub API to post a comment on an Issue with authentication:

http -a USERNAME POST https://api.github.com/repos/httpie/cli/issues/83/comments body='HTTPie is awesome! :heart:'

See more examples →

• Visit the HTTPie website for full documentation and useful links.
• Join our Discord server is to ask questions, discuss features, and for general API chat.
• Tweet at @httpie on Twitter.
• Use StackOverflow to ask questions and include a httpie tag.
• Create GitHub Issues for bug reports and feature requests.
• Subscribe to the HTTPie newsletter for occasional updates.

Have a look through existing Issues and Pull Requests that you could help with. If you'd like to request a feature or report a bug, please create a GitHub Issue using one of the templates provided.

See contribution guide →