httpx

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• httpx

  import httpx

  Top-level module import. All public symbols (Client, AsyncClient, Request, Response, etc.) are available under httpx.*

• httpx.Client
  wrong

  client = httpx.Client()
  r = client.get('https://example.com')
  # never call client.close() manually forgotten

  correct

  with httpx.Client() as client:
      r = client.get('https://example.com')

  Always use Client as a context manager (with statement) to ensure connections are properly closed and pooled.

• httpx.AsyncClient
  wrong

  client = httpx.AsyncClient()
  r = await client.get('https://example.com')

  correct

  async with httpx.AsyncClient() as client:
      r = await client.get('https://example.com')

  Always use AsyncClient as an async context manager. Failing to do so leaks connections. Do not instantiate a new AsyncClient per request — reuse one instance.

• httpx.Timeout
  wrong

  httpx.Client(timeout=5)

  correct

  httpx.Client(timeout=httpx.Timeout(5.0, connect=2.0))

  Passing a plain number sets all timeout phases equally. Use httpx.Timeout() for granular control of connect, read, write, and pool timeouts.

• httpx.BasicAuth / httpx.Auth

  httpx.Client(auth=('user', 'pass'))
  # or
  httpx.Client(auth=httpx.BasicAuth('user', 'pass'))

  Auth can be a (user, pass) tuple or an httpx.Auth subclass. NetRC auth is no longer automatic; use httpx.NetRCAuth() explicitly.

Quickstart verified last tested: 2026-04-23

Minimal sync and async HTTP GET requests using httpx 0.28.x. Uses Client/AsyncClient as context managers for proper connection management.

import httpx

# One-off request (new connection each time — fine for scripts)
r = httpx.get('https://httpbin.org/get', timeout=10.0)
r.raise_for_status()
print(r.status_code)       # 200
print(r.json())            # parsed JSON body

# Recommended: reuse a Client for multiple requests (connection pooling)
with httpx.Client(base_url='https://httpbin.org', timeout=10.0) as client:
    resp = client.get('/get', params={'key': 'value'})
    resp.raise_for_status()
    print(resp.json())

# Async variant
import asyncio

async def main():
    async with httpx.AsyncClient(base_url='https://httpbin.org', timeout=10.0) as client:
        resp = await client.get('/get')
        resp.raise_for_status()
        print(resp.json())

asyncio.run(main())