# Query model catalogs and runtime status

Browse model capabilities and prices, inspect an individual model's health checks, or compare runtime metrics for the last hour. Catalog visibility does not establish calling permission; [list callable models](../../../../reference/api/genesis/models.md) before making an inference request.

## Prerequisites

Prepare a personal access token to query the current user's model catalog and runtime status. The public model catalog and public overview do not require authentication. For authentication and query scope, see [Usage and monitoring](../../../../reference/api/genesis/management/index.md).

## Call sequence

1. Query the public model catalog to browse public models. If you only need the model count and compatible API entry points, query the public overview instead. These queries can be used independently.
2. Query the model catalog for information visible to the current user. Query filter options when building catalog filters, or selection options when you only need a candidate list.
3. To inspect an individual model, use its catalog record identifier to query model health and review the aggregate status and recent channel checks.
4. To compare recent activity, query model runtime status and inspect call counts, latency, and error rates for the last hour.

## API operations

### Browse model catalogs

| Task | API operation | When to use it or what to confirm |
| --- | --- | --- |
| Browse models visible to the current user | [List the model catalog](../../../../reference/api/genesis/management/models/list-models.md) | Obtain capabilities, prices, and catalog record identifiers. |
| Browse public models | [List the public model catalog](../../../../reference/api/genesis/management/models/list-public-models.md) | Inspect enabled public models without authentication. |
| Obtain model candidates | [List model selection options](../../../../reference/api/genesis/management/models/list-select-options.md) | Populate a model selection control. |
| Obtain catalog filters | [Get model filter options](../../../../reference/api/genesis/management/models/get-filter-options.md) | Inspect counts by model type, family, and pricing status. |
| Inspect the public overview | [Get public model overview](../../../../reference/api/genesis/management/models/get-public-overview.md) | Obtain the public model count and compatible API entry points. |

### Inspect health and runtime metrics

| Task | API operation | When to use it or what to confirm |
| --- | --- | --- |
| Inspect one model | [Get model health](../../../../reference/api/genesis/management/models/get-model-health.md) | Use a catalog record identifier to inspect health checks. |
| Compare recent activity | [Get model runtime status](../../../../reference/api/genesis/management/monitoring/get-model-status.md) | Inspect call counts, latency, error rates, and health for the last hour. |

## Confirm the result

Locate the target model in [List the model catalog](../../../../reference/api/genesis/management/models/list-models.md), then inspect the same catalog record with [Get model health](../../../../reference/api/genesis/management/models/get-model-health.md). Runtime metrics describe recent activity; they do not replace checking model authorization for the calling credential.

## Limitations and notes

- A catalog record identifier and the name used for inference serve different purposes. Use the identifier required by each operation.
- The catalog, selection options, and filter options do not support identical filters. Do not reuse every filter across them.
- Runtime status uses the last hour. Other filters affect metric aggregation, not the outer set of enabled models.

## Next steps

- [List callable models](../../../../reference/api/genesis/models.md)
- [Query and investigate request logs](request-logs.md)