---
title: "Available institutions"
method: GET
path: "/catalog/institutions"
tags: ["Catalog"]
deprecated: true
---

# Available institutions

`GET /catalog/institutions`

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/catalog/institutions`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/catalog/institutions/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Returns a list of available institutions along with information for them like metrics and time ranges of available data.

## Query parameters

- `institutions` string[]
- `pretty` boolean

## Response `200`

List of institutions.

- InstitutionsResponse
  - `data` InstitutionInfo[], required
    - `institution` string, required: Unique name of the institution.
    - `metrics` InstitutionMetricInfo[]: List of metrics.
      - `metric` string, required: Name of the metric.
      - `frequencies` InstitutionMetricFrequency[], required: List of metric frequencies.
        - `frequency` string, required: Frequency of the metric.
        - `min_time` string, required: Minimal available time for time series.
        - `max_time` string, required: Maximal available time for time series.

## Other responses

- `400`: Institution not found.
- `401`: Requested resource requires authorization.

---

[API](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)