# edgurgel/httpoison

Yet Another HTTP client for Elixir powered by hackney

Repository: https://github.com/edgurgel/httpoison
Canonical: https://ross.abutalabs.com/products/httpoison
Homepage: https://hex.pm/packages/httpoison
Language: Elixir
License: MIT
License Family: permissive
Topics: elixir, hackney, http-client, http, hacktoberfest
Last push: 2026-07-05T08:37:03+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 91, release rhythm 56, longevity 100
- inputs: {"age_days": 4739, "days_push": 59, "days_rel": 81, "gap_med": 208, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2290, forks 348 (observed 2026-08-28T04:06:34.859841+00:00)

## What it is
HTTPoison is an HTTP client library for Elixir built on top of the Erlang hackney HTTP library. It provides a simple, idiomatic API for making HTTP requests with support for pattern matching on responses and errors.

## Use cases
- make HTTP requests from Elixir
- call REST APIs in an Elixir application
- consume webhooks and third-party APIs
- fetch data over HTTP in a Phoenix app
- send POST requests with JSON bodies from Elixir

## When to choose
- you are building an Elixir or Erlang application that needs an HTTP client
- you want a battle-tested, widely adopted Elixir HTTP client with a large dependant ecosystem
- you prefer explicit ok/error tuples and struct-based responses for pattern matching

## When to avoid
- you need HTTP/2 or advanced features better served by alternatives like Finch or Req
- your project targets Erlang/OTP older than 27, which HTTPoison 3.x does not support
- you want a batteries-included client with built-in JSON decoding, retries, and middleware

## Facets
- artifact type: library
- maturity: stable
- function: http-client
- domain: web-development, apis, backend
- platform: elixir
- tags: hackney, http, rest-client, hex-package, elixir, beam

## Member repositories
- edgurgel/httpoison (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:34.859841+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:40:42.212384+00:00, confidence not recorded.
  - readme: https://github.com/edgurgel/httpoison (fetched 2026-08-28T04:06:34.859841+00:00, sha ba49c380e012)
  - homepage: https://hex.pm/packages/httpoison (fetched 2026-08-29T10:20:58.106761+00:00, sha 17a90a285b28)
  - site_page: https://hex.pm/docs (fetched 2026-08-29T10:20:58.111294+00:00, sha 3f449054c5e0)
  - site_page: https://hex.pm/about (fetched 2026-08-29T10:20:58.112956+00:00, sha 627eac420427)
  - site_page: https://hex.pm/docs/faq (fetched 2026-08-29T10:20:58.114617+00:00, sha 2914acf2582a)
  - site_page: https://hex.pm/pricing (fetched 2026-08-29T10:20:58.109283+00:00, sha b0a5082843ed)
- Data as of 2026-08-30T08:39:29.467469+00:00.