HTTPie

Modern, user-friendly HTTP client for the terminal. Send requests, inspect responses, and test APIs with intuitive syntax.

64 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

HTTP Requests

Make requests

21commands

Authentication

Auth methods

6commands

Headers

Custom headers

6commands

Output

Response formatting

22commands

Sessions

Persistent sessions

6commands

Install HTTPie (macOS)

$ brew install httpie

Install HTTPie HTTP client using Homebrew on macOS

Install HTTPie (pip)

$ pip install httpie

Install HTTPie HTTP client using pip on any platform

Check HTTPie version

$ http --version

Verify HTTPie is installed and display the current version

Basic Auth

$ http -a username:password GET https://api.example.com/protected

Use Basic Authentication.

Bearer token

$ http -A bearer -a token123 GET https://api.example.com/users

Use Bearer token authentication.

Auth header directly

$ http GET https://api.example.com/users Authorization:'Bearer token123'

Set Authorization header directly.

Digest auth

$ http --auth-type=digest -a user:pass https://api.example.com

Use Digest authentication.

Prompt for password

$ http -a username GET https://api.example.com/protected

Omit password to get an interactive prompt.

Netrc authentication

$ http --auth-type=netrc GET https://api.example.com/data

Use credentials from ~/.netrc file.

Custom header

$ http GET https://api.example.com X-Custom-Header:value

Add a custom header.

Content-Type

$ http POST https://api.example.com Content-Type:application/xml < data.xml

Set Content-Type header.

Accept header

$ http GET https://api.example.com Accept:application/json

Set Accept header.

Remove header

$ http GET https://api.example.com User-Agent:

Remove a default header.

Multiple custom headers

$ http GET https://api.example.com X-Request-ID:abc123 X-Api-Version:v2 Accept:application/json

Set multiple custom headers in a single request.

Empty header value

$ http GET https://api.example.com X-Empty-Header;

Send a header with an empty value using ; syntax.

Create session

$ http --session=api POST https://api.example.com/login user=admin pass=secret

Create a named session.

Use session

$ http --session=api GET https://api.example.com/protected

Use an existing session.

Read-only session

$ http --session-read-only=api GET https://api.example.com/data

Use session without saving changes.

Anonymous session

$ http --session=./session.json POST https://api.example.com/login

Save session to specific file.

Session with auth

$ http --session=dev -a user:pass GET https://api.example.com/data

Create a named session that persists auth credentials for reuse.

Session with headers

$ http --session=prod GET https://api.example.com/data X-Api-Key:secret123

Store custom headers in a session for repeated use.

Discussion

Loading comments...

HTTPie

Modern, user-friendly HTTP client for the terminal. Send requests, inspect responses, and test APIs with intuitive syntax.

64 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

HTTP Requests

Make requests

21commands

Authentication

Auth methods

6commands

Headers

Custom headers

6commands

Output

Response formatting

22commands

Sessions

Persistent sessions

6commands

Install HTTPie (macOS)

$ brew install httpie

Install HTTPie HTTP client using Homebrew on macOS

Install HTTPie (pip)

$ pip install httpie

Install HTTPie HTTP client using pip on any platform

Check HTTPie version

$ http --version

Verify HTTPie is installed and display the current version

Basic Auth

$ http -a username:password GET https://api.example.com/protected

Use Basic Authentication.

Bearer token

$ http -A bearer -a token123 GET https://api.example.com/users

Use Bearer token authentication.

Auth header directly

$ http GET https://api.example.com/users Authorization:'Bearer token123'

Set Authorization header directly.

Digest auth

$ http --auth-type=digest -a user:pass https://api.example.com

Use Digest authentication.

Prompt for password

$ http -a username GET https://api.example.com/protected

Omit password to get an interactive prompt.

Netrc authentication

$ http --auth-type=netrc GET https://api.example.com/data

Use credentials from ~/.netrc file.

Custom header

$ http GET https://api.example.com X-Custom-Header:value

Add a custom header.

Content-Type

$ http POST https://api.example.com Content-Type:application/xml < data.xml

Set Content-Type header.

Accept header

$ http GET https://api.example.com Accept:application/json

Set Accept header.

Remove header

$ http GET https://api.example.com User-Agent:

Remove a default header.

Multiple custom headers

$ http GET https://api.example.com X-Request-ID:abc123 X-Api-Version:v2 Accept:application/json

Set multiple custom headers in a single request.

Empty header value

$ http GET https://api.example.com X-Empty-Header;

Send a header with an empty value using ; syntax.

Create session

$ http --session=api POST https://api.example.com/login user=admin pass=secret

Create a named session.

Use session

$ http --session=api GET https://api.example.com/protected

Use an existing session.

Read-only session

$ http --session-read-only=api GET https://api.example.com/data

Use session without saving changes.

Anonymous session

$ http --session=./session.json POST https://api.example.com/login

Save session to specific file.

Session with auth

$ http --session=dev -a user:pass GET https://api.example.com/data

Create a named session that persists auth credentials for reuse.

Session with headers

$ http --session=prod GET https://api.example.com/data X-Api-Key:secret123

Store custom headers in a session for repeated use.

Discussion

Loading comments...