# @backstage/catalog-client

> An isomorphic client for the catalog backend

Latest version **1.16.2** (published 2026-09-15) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @backstage/catalog-client
pnpm add @backstage/catalog-client
yarn add @backstage/catalog-client
bun add @backstage/catalog-client
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.16.2 |
| Published | 2026-09-15 |
| First published | 2020-11-04 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 7 |
| Unpacked size | 510.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 34428 |
| Maintainers | patriko, freben, marcuseide |
| Keywords | backstage |

## Links

- npm: https://www.npmjs.com/package/@backstage/catalog-client
- Repository: https://github.com/backstage/backstage
- Homepage: https://backstage.io
- npm.io page: https://npm.io/package/@backstage/catalog-client

## Dependencies (7)

- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [cross-fetch](https://npm.io/package/cross-fetch.md) ^4.0.0
- [uri-template](https://npm.io/package/uri-template.md) ^2.0.0
- [@backstage/errors](https://npm.io/package/@backstage/errors.md) ^1.3.1
- [@backstage/catalog-model](https://npm.io/package/@backstage/catalog-model.md) ^1.10.1
- [@backstage/filter-predicates](https://npm.io/package/@backstage/filter-predicates.md) ^0.1.5
- [@backstage/plugin-catalog-common](https://npm.io/package/@backstage/plugin-catalog-common.md) ^1.2.0

## Recent versions

- 1.16.2 (latest) — 2026-09-15
- 0.0.0-nightly-20260926022852 (nightly) — 2026-09-26
- 1.16.3-next.0 (next) — 2026-09-22
- 0.0.0-nightly-20260925022940 — 2026-09-25
- 0.0.0-nightly-20260924023050 — 2026-09-24
- 0.0.0-nightly-20260923023054 — 2026-09-23
- 0.0.0-nightly-20260922023058 — 2026-09-22
- 0.0.0-nightly-20260921023416 — 2026-09-21
- 0.0.0-nightly-20260920023043 — 2026-09-20
- 0.0.0-nightly-20260919022921 — 2026-09-19
- 0.0.0-nightly-20260909022715 — 2026-09-09
- 1.16.2-next.1 — 2026-09-08
- 0.0.0-nightly-20260904022803 — 2026-09-04
- 0.0.0-nightly-20260902024315 — 2026-09-02
- 1.16.2-next.0 — 2026-09-01
- … 1117 more at https://npm.io/package/@backstage/catalog-client/versions

## README

# Catalog Client

Contains a frontend and backend compatible client for communicating with the
Backstage Catalog.

Backend code may import and use this package directly.

However, frontend code will not want to instantiate a catalog client directly -
use the `@backstage/plugin-catalog-react` package instead, which exports a
`catalogApiRef` that can be leveraged like other frontend utility APIs.

## Links

- [Default frontend part of the catalog](https://github.com/spotify/backstage/tree/master/plugins/catalog)
- [Default backend part of the catalog](https://github.com/spotify/backstage/tree/master/plugins/catalog-backend)
- [The Backstage homepage](https://backstage.io)

---
_Source: https://npm.io/package/@backstage/catalog-client · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._