---
title: "Recall matches for a catalog, newest first, a page at a time"
method: GET
path: "/v1/catalogs/{id}/matches"
---

# Recall matches for a catalog, newest first, a page at a time

`GET /v1/catalogs/{id}/matches`

## Request

- Base URL: `https://api.recallsapi.com`
- URL: `https://api.recallsapi.com/v1/catalogs/{id}/matches`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required

## Query parameters

- `status` 'open' | 'dismissed' | 'all'
- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `matches` object[]
  - `next_cursor` string, nullable

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid API key
- `429`: Daily quota reached

---

[API](https://skmtc.dev/recallsapi/apis/recallsapi-com.md) · [All operations](https://skmtc.dev/recallsapi/apis/recallsapi-com/llms.txt) · [OpenAPI document](https://skmtc.dev/recallsapi/apis/recallsapi-com/revisions/2501df40ea54?raw)