---
title: "Get Institution Metadata"
method: POST
path: "/api/v3/institutions/metadata"
tags: ["Institutions"]
---

# Get Institution Metadata

`POST /api/v3/institutions/metadata`

Get institution counts and metadata based on filters.

Request body should contain a list of filters, where each filter can specify:
- institution_type: Filter by type (k12_districts, cities, etc.)
- states: List of state codes (e.g., ["CA", "NY", "TX"])
- population_min: Minimum population filter
- population_max: Maximum population filter

If no filters provided, returns counts for all institution types.

## Request body

- InstitutionCountsRequest
  - `filters` InstitutionFilter[]
    - `ids` string[] — List of institution IDs to filter by
    - `limit` integer, nullable — Limit number of results returned
    - `institution_type` string, nullable — Filter by institution type (e.g., k12_districts, cities)
    - `account_types` string[], nullable — Multi-select institution types — applied as source_table IN (...)
    - `states` string[], nullable — List of state codes to filter by
    - `counties` string[], nullable — List of county names to filter by
    - `cities` string[], nullable — List of city names to filter by
    - `population_min` integer, nullable — Minimum population filter
    - `population_max` integer, nullable — Maximum population filter
    - `search_query` string, nullable — Case-insensitive substring match on Institution.name

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)