---
title: "GET /wordlift/v1/term-matches"
method: GET
path: "/wordlift/v1/term-matches"
tags: ["Term Matches"]
---

# GET /wordlift/v1/term-matches

`GET /wordlift/v1/term-matches`

Returns a list of term matches for a given taxonomy.

## Query parameters

- `cursor` string
- `limit` number
- `has_match` boolean
- `term_contains` string
- `sort` '+term_name' | '-term_name' | '+entity_name' | '-entity_name' | '+ingredient_term' | '-ingredient_term' | '+matched_ingredient' | '-matched_ingredient' | '+occurrences' | '-occurrences'

## Response `200`

OK

- PageTermMatch
  - `self` string — The URL of the current page.
  - `first` string — The URL of the first page.
  - `prev` string — The URL of the previous page.
  - `next` string — The URL of the next page.
  - `last` string — The URL of the last page.
  - `items` TermMatch[]
    - `name` string, required — The name of the term
    - `id` integer, required — The ID of the term.
    - `match_name` string, required — The name of the matched term.
    - `match_id` integer, required — The ID of the matched term.
    - `match_jsonld` string — The JSON-LD of the matched term.
    - `occurrences` integer, required — The number of times the term is used.

---

[API](https://skmtc.net/insideout10/apis/wordlift-plugin.md) · [All operations](https://skmtc.net/insideout10/apis/wordlift-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/insideout10/wordlift-plugin/revisions/00576e6d31eb/schema)