---
title: "Read current values for one search facet"
method: GET
path: "/api/v1/facets/{facet}"
tags: ["Discovery"]
---

# Read current values for one search facet

`GET /api/v1/facets/{facet}`

## Request

- Base URL: `https://openmedici.com`
- URL: `https://openmedici.com/api/v1/facets/{facet}`
- Auth: none required

Facet values come from published data and may grow without an API version change.

## Path parameters

- `facet` 'types' | 'lifecycles' | 'fields' | 'countries' | 'destinations' | 'careers' | 'topics' | 'applicants' | 'audiences' | 'benefits' | 'citizenships' | 'residences' | 'education' | 'enrollments' | 'fundingShapes' | 'durationUnits' | 'openStates', required

## Query parameters

- `q` string
- `limit` integer
- `offset` integer

## Response `200`

Successful response

- FacetResponse
  - `data` FacetItem[], required
    - `value` string, required
    - `label` string, required
    - `count` integer, required
  - `meta` object, required
    - `facet` string, required
    - `q` string, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required
    - `total` integer, required

## Other responses

- `400`: Facet query is invalid
- `404`: Facet not found

---

[API](https://skmtc.dev/openmedici/apis/open-medici-public-api.md) · [All operations](https://skmtc.dev/openmedici/apis/open-medici-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openmedici/apis/open-medici-public-api/revisions/3b7a349ded21?raw)