---
title: "Get user catalog metadata"
method: GET
path: "/api/v1/catalog/catalogs/{catalog_name}"
tags: ["catalogs"]
---

# Get user catalog metadata

`GET /api/v1/catalog/catalogs/{catalog_name}`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Get user catalog metadata.

Path Parameters:
- **catalog_name**: The name of the catalog

Returns:
- **UserCatalog**: The user catalog metadata including id, name, and created_at.

## Path parameters

- `catalog_name` string, required

## Response `200`

The user catalog metadata

- UserCatalog
  - `id` integer, required
  - `name` string, required
  - `created_at` string, date-time, required

## Other responses

- `404`: The catalog with the given name was not found
- `422`: The search terms given could not be processed

## Changes

- **2026-07-28** `05d6283fc201`: 1 warning
  - changed the pattern of the `path` request parameter `catalog_name` from `[a-zA-Z0-9\-_]{3,64}` to `^[a-zA-Z0-9\-_]{3,63}$`
- **2026-04-13** `b99206a49d27`: 1 warning
  - removed the optional property `owner_handle` from the response with the `200` status
- **2025-07-25** `29c059f1823a`: 1 info
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-03-20** `dcd958492a63`: 2 info
  - api tag `catalogs` added
  - api tag `user_catalogs` removed
- **2024-10-09** `3794b64a27fa`: 1 info
  - added the optional property `owner_handle` to the response with the `200` status

[Operation history](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/catalogs/:catalog_name/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.dev/flox/apis/floxhub-catalog-server/revisions/6731453cd7cd?raw)