---
title: "Find packages that provide a command"
method: GET
path: "/api/v1/catalog/by-command"
tags: ["catalog"]
---

# Find packages that provide a command

`GET /api/v1/catalog/by-command`

Reverse lookup: which package(s) provide the given command name.

Required Query Parameters:
- **system**: The system architecture to search for (e.g., x86_64-linux)
- **name**: The command name to look up (e.g., readelf, rg, gcc-13)

Optional Query Parameters:
- **page**: Page number for pagination (default: 0)
- **pageSize**: Page size for pagination (default: 10)

Returns:
- **ByCommandResult**: Providers of the command and total count

## Query parameters

- `system` 'aarch64-darwin' | 'aarch64-linux' | 'x86_64-darwin' | 'x86_64-linux' | 'invalid', required
- `name` string, required
- `page` integer
- `pageSize` integer

## Response `200`

Packages that provide the given command

- ByCommandResult — Packages that provide a command name (reverse command→package lookup).
  - `command_name` string, required
  - `providers` CommandProvider[], required
    - `attr_path` string, required
    - `pname` string, required
    - `exact_name_match` boolean, required
    - `system` 'aarch64-darwin' | 'aarch64-linux' | 'x86_64-darwin' | 'x86_64-linux' | 'invalid', required
  - `total_count` integer, required
  - `listing_known` boolean, required

## Other responses

- `422` — The command name or system could not be processed

## Changes

- **2026-08-19** `3541e86c7ef9` — 2 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `pageSize`
- **2026-08-14** `11bdb74527de` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/by-command/get.md)

---

[API](https://skmtc.dev/flox/apis/floxhub-catalog-server.md) · [All operations](https://skmtc.dev/flox/apis/floxhub-catalog-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flox/floxhub-catalog-server/revisions/8ec561551880/schema)