---
title: "List Post Matches"
method: GET
path: "/wordlift/v1/post-matches"
tags: ["Post Matches"]
---

# List Post Matches

`GET /wordlift/v1/post-matches`

List the post matches

## Query parameters

- `cursor` string
- `limit` integer
- `post_types` string[]
- `has_match` boolean
- `post_status` 'publish' | 'draft'
- `sort` '+date_modified_gmt' | '-date_modified_gmt'

## Response `200`

The list of post matches

- PagePostMatch
  - `first` string
  - `prev` string
  - `next` string
  - `last` string
  - `items` PostMatch[]
    - `id` integer, required
    - `post_title` string, required
    - `post_status` string, required
    - `parent_post_title` string
    - `parent_post_id` string
    - `parent_post_link` string
    - `match_jsonld` string
    - `match_id` integer
    - `match_name` string
    - `post_link` string, required
    - `view_link` string, required
    - `preview_link` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[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)