# Hex.pm

> Look up Elixir, Erlang and Gleam packages on Hex.pm, the package registry of the Erlang ecosystem. Search packages and rank them by downloads, newest or recently updated; read a package, its releases and one release's dependencies, publisher and retirement; list a package's owners and security advisories; and look up a user and the packages they own. A trigger starts a workflow when a package publishes a new release. No account or API key required.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/hex-pm

## Actions

### Get a package

Read a package on Hex.pm: its description, latest and latest stable versions, licences, links, downloads (all time, last 90 days, last week and yesterday), owners, how many releases it has and which are retired, how many security advisories it has, and the lines that add it to a mix.exs, rebar.config or erlang.mk project.

**Inputs**

- Package (`package`, text, required): The package's name on Hex.pm. Pick one of the most downloaded from the list, or type any name; a hex.pm or HexDocs address works too.

**Outputs**

- `description` (text): The package's own one-line description
- `docs_url` (text): Its documentation on HexDocs; empty when it has none
- `downloads_all_time` (number): Downloads of every version, ever
- `downloads_last_7_days` (number): Downloads in the last seven days
- `downloads_last_90_days` (number): Downloads in the last 90 days
- `downloads_yesterday` (number): Downloads yesterday
- `erlang_mk_dependency` (text): The line that adds it to an erlang.mk Makefile, such as dep_phoenix = hex 1.8.16
- `first_published_at` (text): When it was first published, in ISO 8601 UTC
- `last_published_at` (text): When it last published a release of any version, in ISO 8601 UTC
- `latest_stable_version` (text): The newest version that is not a pre-release; empty when it has none
- `latest_version` (text): The newest version, pre-releases included
- `licenses` (list): The licences it is published under, such as MIT
- `links` (list): The links its owners give, such as GitHub
- `mix_dependency` (text): The line that adds it to an Elixir project's mix.exs, such as {:phoenix, "~> 1.8"}
- `name` (text): The package's name
- `owners` (list): The usernames of the people who can publish it; 'List a package's owners' gives their details
- `rebar_dependency` (text): The line that adds it to an Erlang project's rebar.config, such as {phoenix, "1.8.16"}
- `release_count` (number): How many versions it has published
- `repository` (text): The Hex repository it is in: hexpm for public packages
- `retired_versions` (list): Versions its owners have retired, telling people not to use them
- `security_advisory_count` (number): How many security advisories have been published against it
- `source_url` (text): Where its source code lives, such as its GitHub page; empty when it names none
- `updated_at` (text): When the package last changed, in ISO 8601 UTC
- `url` (text): The package's page on hex.pm

**Example output**

```json
{
  "description": "A blazing fast JSON parser and generator in pure Elixir.",
  "docs_url": "https://jason.hexdocs.pm/",
  "downloads_all_time": 216018813,
  "downloads_last_7_days": 1099300,
  "downloads_last_90_days": 10645598,
  "downloads_yesterday": 112522,
  "erlang_mk_dependency": "dep_jason = hex 1.4.5",
  "first_published_at": "2017-12-22T09:32:40Z",
  "last_published_at": "2026-05-05T14:34:53Z",
  "latest_stable_version": "1.4.5",
  "latest_version": "1.5.0-alpha.2",
  "licenses": [
    "Apache-2.0"
  ],
  "links": [
    {
      "name": "GitHub",
      "url": "https://github.com/michalmuskala/jason"
    }
  ],
  "mix_dependency": "{:jason, \"~> 1.4\"}",
  "name": "jason",
  "owners": [
    "michalmuskala"
  ],
  "rebar_dependency": "{jason, \"1.4.5\"}",
  "release_count": 20,
  "repository": "hexpm",
  "retired_versions": [],
  "security_advisory_count": 0,
  "source_url": "https://github.com/michalmuskala/jason",
  "updated_at": "2026-05-05T14:34:54Z",
  "url": "https://hex.pm/packages/jason"
}
```

### Get a release

Read one version of a package: when it was published and by whom, whether it is the latest stable release, a pre-release or retired (and why), the Elixir version and packages it needs, the security advisories that affect it, its downloads, its checksum and its documentation.

**Inputs**

- Package (`package`, text, required): The package's name on Hex.pm. Pick one of the most downloaded from the list, or type any name; a hex.pm or HexDocs address works too.
- Version (`version`, text, required): The version to read. Pick one from the list, or type a version number, or latest for the newest stable release.

**Outputs**

- `build_tools` (list): The tools that can build it, such as mix or rebar3
- `checksum` (text): The SHA-256 checksum of the release's package file
- `dependencies` (list): The packages it depends on, by name
- `dependency_count` (number): How many packages it depends on
- `docs_url` (text): Its documentation on HexDocs; empty when it has none
- `downloads` (number): How many times this version has been downloaded
- `elixir_requirement` (text): The Elixir versions it needs, such as ~> 1.15; empty when it names none
- `erlang_mk_dependency` (text): The line that adds it to an erlang.mk Makefile, such as dep_phoenix = hex 1.8.16
- `has_docs` (true/false): True when it has documentation on HexDocs
- `is_latest_stable` (true/false): True when it is the package's newest stable release
- `is_prerelease` (true/false): True for a pre-release, such as 1.8.0-rc.0
- `is_retired` (true/false): True when its owners have retired it
- `mix_dependency` (text): The line that adds it to an Elixir project's mix.exs, such as {:phoenix, "~> 1.8"}
- `otp_app` (text): The OTP application it provides
- `package` (text): The package's name
- `published_at` (text): When it was published, in ISO 8601 UTC
- `publisher` (text): The username of the person who published it
- `rebar_dependency` (text): The line that adds it to an Erlang project's rebar.config, such as {phoenix, "1.8.16"}
- `retirement_message` (text): What its owners said when retiring it
- `retirement_reason` (text): Why it was retired: security, invalid, deprecated, renamed or other; empty when it is not retired
- `security_advisory_ids` (list): The security advisories that affect this version, such as GHSA-6983-jfq8-485w
- `updated_at` (text): When the release last changed, in ISO 8601 UTC
- `url` (text): The release's page on hex.pm
- `version` (text): The version number, such as 1.8.16

**Example output**

```json
{
  "build_tools": [
    "mix"
  ],
  "checksum": "cf784932e010fd736d656d7fead6a584a4498efefe5b8227e9f383bf15bb79d0",
  "dependencies": [
    {
      "app": "castore",
      "optional": false,
      "package": "castore",
      "requirement": ">= 0.0.0"
    },
    {
      "app": "jason",
      "optional": true,
      "package": "jason",
      "requirement": "~> 1.0"
    },
    {
      "app": "phoenix_pubsub",
      "optional": false,
      "package": "phoenix_pubsub",
      "requirement": "~> 2.1"
    },
    {
      "app": "phoenix_template",
      "optional": false,
      "package": "phoenix_template",
      "requirement": "~> 1.0"
    },
    {
      "app": "phoenix_view",
      "optional": true,
      "package": "phoenix_view",
      "requirement": "~> 2.0"
    },
    {
      "app": "plug",
      "optional": false,
      "package": "plug",
      "requirement": "~> 1.14"
    },
    {
      "app": "plug_cowboy",
      "optional": true,
      "package": "plug_cowboy",
      "requirement": "~> 2.6"
    },
    {
      "app": "plug_crypto",
      "optional": false,
      "package": "plug_crypto",
      "requirement": "~> 1.2 or ~> 2.0"
    },
    {
      "app": "telemetry",
      "optional": false,
      "package": "telemetry",
      "requirement": "~> 0.4 or ~> 1.0"
    },
    {
      "app": "websock_adapter",
      "optional": false,
      "package": "websock_adapter",
      "requirement": "~> 0.5.3"
    }
  ],
  "dependency_count": 10,
  "docs_url": "https://phoenix.hexdocs.pm/1.7.10/",
  "downloads": 2414012,
  "elixir_requirement": "~> 1.11",
  "erlang_mk_dependency": "dep_phoenix = hex 1.7.10",
  "has_docs": true,
  "is_latest_stable": false,
  "is_prerelease": false,
  "is_retired": false,
  "mix_dependency": "{:phoenix, \"~> 1.7\"}",
  "otp_app": "phoenix",
  "package": "phoenix",
  "published_at": "2023-11-03T13:25:41Z",
  "publisher": "chrismccord",
  "rebar_dependency": "{phoenix, \"1.7.10\"}",
  "retirement_message": "",
  "retirement_reason": "",
  "security_advisory_ids": [
    "GHSA-6983-jfq8-485w",
    "GHSA-63mc-hw7g-86rr",
    "EEF-CVE-2026-56812",
    "EEF-CVE-2026-56811",
    "GHSA-628h-q48j-jr6q",
    "EEF-CVE-2026-32689"
  ],
  "updated_at": "2023-11-03T13:25:47Z",
  "url": "https://hex.pm/packages/phoenix/1.7.10",
  "version": "1.7.10"
}
```

### Get a user

Read a Hex.pm user's profile: their name, public email, accounts elsewhere, when they joined, and every package they own.

**Inputs**

- Username (`username`, text, required): Their Hex.pm username, their email address, or their hex.pm profile address. 'List a package's owners' gives the usernames behind a package.

**Outputs**

- `email` (text): Their public email address; empty when they keep it private
- `full_name` (text): Their name, when they give it
- `handles` (list): Their accounts elsewhere, such as GitHub
- `joined_at` (text): When they joined Hex.pm, in ISO 8601 UTC
- `package_count` (number): How many packages they own
- `packages` (list): The packages they own
- `updated_at` (text): When their profile last changed, in ISO 8601 UTC
- `url` (text): Their profile on hex.pm
- `username` (text): Their Hex.pm username

**Example output**

```json
{
  "email": "jose.valim@gmail.com",
  "full_name": "",
  "handles": [],
  "joined_at": "2014-04-23T16:23:58Z",
  "package_count": 3,
  "packages": [
    {
      "name": "ecto",
      "url": "https://hex.pm/packages/ecto"
    },
    {
      "name": "phoenix",
      "url": "https://hex.pm/packages/phoenix"
    },
    {
      "name": "plug",
      "url": "https://hex.pm/packages/plug"
    }
  ],
  "updated_at": "2026-05-14T09:19:38Z",
  "url": "https://hex.pm/users/josevalim",
  "username": "josevalim"
}
```

### List a package's owners

List the people who can publish and retire a package's releases, with their name, whether they are a full owner or a maintainer, their public email and their accounts elsewhere, such as GitHub.

**Inputs**

- Package (`package`, text, required): The package's name on Hex.pm. Pick one of the most downloaded from the list, or type any name; a hex.pm or HexDocs address works too.

**Outputs**

- `count` (number): How many owners it has
- `owners` (list): The people who can publish the package
- `package` (text): The package's name

**Example output**

```json
{
  "count": 2,
  "owners": [
    {
      "email": "eric.meadows.jonsson@gmail.com",
      "full_name": "Eric Meadows-J\u00f6nsson",
      "handles": [
        {
          "service": "Elixir Forum",
          "url": "https://elixirforum.com/u/ericmj"
        },
        {
          "service": "GitHub",
          "url": "https://github.com/ericmj"
        }
      ],
      "joined_at": "2014-04-21T17:20:12Z",
      "level": "full",
      "url": "https://hex.pm/users/ericmj",
      "username": "ericmj"
    },
    {
      "email": "jose.valim@gmail.com",
      "full_name": "",
      "handles": [],
      "joined_at": "2014-04-23T16:23:58Z",
      "level": "full",
      "url": "https://hex.pm/users/josevalim",
      "username": "josevalim"
    }
  ],
  "package": "ecto"
}
```

### List a package's releases

List the versions a package has published, highest version or most recently published first, with when each was published, whether it is a pre-release, whether it is retired and why, and its documentation. Narrow it to stable or unretired releases, or to those published since a date.

**Inputs**

- Package (`package`, text, required): The package's name on Hex.pm. Pick one of the most downloaded from the list, or type any name; a hex.pm or HexDocs address works too.
- Order (`order`, text): Which release comes first. One of: `version` (Highest version first), `published` (Most recently published first). Default: `version`.
- Include pre-releases (`include_prereleases`, true/false): Include versions such as 1.8.0-rc.0 and 2.0.0-beta.1. Default: `true`.
- Include retired releases (`include_retired`, true/false): Include versions their owners have retired. Default: `true`.
- Published on or after (`published_after`, date): Only releases published on this day or later (UTC). Leave empty for every release.
- How many to return (`limit`, number): How many releases to return, up to 500. Defaults to 25; the result says how many matched altogether. From 1 to 500. Default: `25`.

**Outputs**

- `count` (number): How many releases are in this result
- `latest_stable_version` (text): The newest version that is not a pre-release; empty when it has none
- `latest_version` (text): The newest version, pre-releases included
- `matched_count` (number): How many releases matched, before the limit
- `order` (text): The order: version (highest first) or published (most recent first)
- `package` (text): The package's name
- `releases` (list): The matching releases, in the order asked for
- `total_count` (number): How many releases the package has altogether

**Example output**

```json
{
  "count": 3,
  "latest_stable_version": "1.8.16",
  "latest_version": "1.8.16",
  "matched_count": 161,
  "order": "published",
  "package": "phoenix",
  "releases": [
    {
      "docs_url": "https://phoenix.hexdocs.pm/1.8.16/",
      "has_docs": true,
      "is_prerelease": false,
      "is_retired": false,
      "published_at": "2026-10-20T10:33:05Z",
      "retirement_message": "",
      "retirement_reason": "",
      "url": "https://hex.pm/packages/phoenix/1.8.16",
      "version": "1.8.16"
    },
    {
      "docs_url": "https://phoenix.hexdocs.pm/1.8.15/",
      "has_docs": true,
      "is_prerelease": false,
      "is_retired": false,
      "published_at": "2026-09-25T13:19:05Z",
      "retirement_message": "",
      "retirement_reason": "",
      "url": "https://hex.pm/packages/phoenix/1.8.15",
      "version": "1.8.15"
    },
    {
      "docs_url": "https://phoenix.hexdocs.pm/1.8.14/",
      "has_docs": true,
      "is_prerelease": false,
      "is_retired": false,
      "published_at": "2026-09-14T09:39:55Z",
      "retirement_message": "",
      "retirement_reason": "",
      "url": "https://hex.pm/packages/phoenix/1.8.14",
      "version": "1.8.14"
    }
  ],
  "total_count": 183
}
```

### List a package's security advisories

List the security advisories published against a package, newest first, with their severity and CVSS score, the versions they affect and links to the fix. Give a version to check whether that release is affected, or a minimum severity to keep only the serious ones.

**Inputs**

- Package (`package`, text, required): The package's name on Hex.pm. Pick one of the most downloaded from the list, or type any name; a hex.pm or HexDocs address works too.
- Affecting version (`version`, text): Only advisories that affect this version. Pick one, type one, or type latest. Leave empty for every advisory.
- Minimum severity (`min_severity`, text): Only advisories at least this severe. Leave empty for every advisory; unrated ones are left out when this is set. One of: `low` (Low and above), `medium` (Medium and above), `high` (High and above), `critical` (Critical only).

**Outputs**

- `advisories` (list): The matching advisories, most recently published first
- `count` (number): How many advisories are in this result
- `package` (text): The package's name
- `total_count` (number): How many advisories there are before the severity filter
- `version` (text): The version that was checked; empty when every advisory against the package was listed

**Example output**

```json
{
  "advisories": [
    {
      "affected_versions": [
        ">= 2.2.0 and < 2.2.1"
      ],
      "aliases": [
        "CVE-2017-20166"
      ],
      "cvss_score": 9.8,
      "cvss_vector": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H",
      "id": "GHSA-2xxx-fhc8-9qvq",
      "is_withdrawn": false,
      "modified_at": "2026-07-08T06:00:56Z",
      "published_at": "2022-04-12T19:42:45Z",
      "references": [
        "https://nvd.nist.gov/vuln/detail/CVE-2017-20166",
        "https://github.com/elixir-ecto/ecto/pull/2125"
      ],
      "severity": "critical",
      "summary": "Ecto missing `is_nil` requirement",
      "url": "https://osv.dev/vulnerability/GHSA-2xxx-fhc8-9qvq",
      "withdrawn_at": ""
    }
  ],
  "count": 1,
  "package": "ecto",
  "total_count": 1,
  "version": ""
}
```

### Search packages

Find Elixir, Erlang and Gleam packages on Hex.pm by words in their name or description, or list every package, ranked by downloads in the last 90 days or of all time, newest, most recently updated or by name. Each result comes with its latest versions, description, licences, downloads and links.

**Inputs**

- Search for (`query`, text): Words to look for in package names and descriptions. Hex.pm's own filters work too, such as name:phoenix_* or description:websocket. Leave empty to list every package in the chosen order.
- Sort by (`sort`, text): How to order the packages. One of: `recent_downloads` (Most downloaded in the last 90 days), `total_downloads` (Most downloaded of all time), `inserted_at` (Newest packages first), `updated_at` (Recently updated first), `name` (Name, A to Z). Default: `recent_downloads`.
- How many to return (`limit`, number): How many packages to return, up to 100. Defaults to 20. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results to return, counting from 1, each page holding 'How many to return' packages. Defaults to the first. From 1 to 1000. Default: `1`.

**Outputs**

- `count` (number): How many packages are in this result
- `more_available` (true/false): True when there are probably more packages on the next page
- `packages` (list): The matching packages, in the order asked for
- `page` (number): Which page of results this is, counting from 1
- `query` (text): The search as it was sent; empty when every package was listed
- `search_url` (text): The same search on hex.pm
- `sort` (text): The order: recent_downloads, total_downloads, inserted_at, updated_at or name

**Example output**

```json
{
  "count": 2,
  "more_available": true,
  "packages": [
    {
      "description": "A blazing fast JSON parser and generator in pure Elixir.",
      "docs_url": "https://jason.hexdocs.pm/",
      "downloads_all_time": 216018813,
      "downloads_last_90_days": 10645598,
      "latest_stable_version": "1.4.5",
      "latest_version": "1.5.0-alpha.2",
      "licenses": [
        "Apache-2.0"
      ],
      "name": "jason",
      "source_url": "https://github.com/michalmuskala/jason",
      "updated_at": "2026-05-05T14:34:54Z",
      "url": "https://hex.pm/packages/jason"
    },
    {
      "description": "JSON Object Signing and Encryption (JOSE) for Erlang and Elixir.",
      "docs_url": "https://jose.hexdocs.pm/",
      "downloads_all_time": 114677292,
      "downloads_last_90_days": 3841673,
      "latest_stable_version": "1.11.13",
      "latest_version": "1.11.13",
      "licenses": [
        "MIT"
      ],
      "name": "jose",
      "source_url": "https://github.com/potatosalad/erlang-jose",
      "updated_at": "2026-10-26T20:10:05Z",
      "url": "https://hex.pm/packages/jose"
    }
  ],
  "page": 1,
  "query": "json",
  "search_url": "https://hex.pm/packages?search=json&sort=recent_downloads",
  "sort": "recent_downloads"
}
```
