---
title: "Paginated listing of taxonomy terms"
method: POST
path: "/taxonomy_terms"
tags: ["optional"]
---

# Paginated listing of taxonomy terms

`POST /taxonomy_terms`

Full information on a taxonomy term

## Query parameters

- `search` string
- `page` integer
- `per_page` integer
- `format` string
- `taxonomy_id` string
- `top_only` boolean
- `parent_id` string

## Response `200`

Paginated listing of taxonomy terms

- object
  - `total_items` integer — The total number of entities (e.g. services, organizations) returned
  - `total_pages` integer — Count of total pages.
  - `page_number` integer — The number of the current page
  - `size` integer — The number of entities in the current page.
  - `first_page` boolean — A Boolean value indicating if this is the first page
  - `last_page` boolean — A Boolean value indicating if this is the last page
  - `empty` boolean, required — A Boolean value indicating if there is an empty result set
  - `contents` TaxonomyTermJson[], required — unresolved $ref

---

[API](https://skmtc.net/openreferral/apis/required-title-of-your-api-here.md) · [All operations](https://skmtc.net/openreferral/apis/required-title-of-your-api-here/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openreferral/required-title-of-your-api-here/revisions/86dad57d605b/schema)