Skip to main content
GET
/
catchAll
/
monitors
List monitors
curl --request GET \
  --url https://catchall.newscatcherapi.com/catchAll/monitors \
  --header 'x-api-key: <api-key>'
{
  "total": 3,
  "page": 1,
  "page_size": 100,
  "total_pages": 1,
  "monitors": [
    {
      "monitor_id": "7f3a8b2c-1e4d-4a5b-9c8d-6e7f8a9b0c1d",
      "reference_job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
      "reference_job_query": "Series B funding rounds for SaaS startups",
      "enabled": true,
      "schedule": "0 12 * * *",
      "schedule_human_readable": "Every day at 12 PM",
      "timezone": "UTC",
      "created_at": "2026-02-24T14:00:00Z",
      "webhook": {
        "url": "https://example.com/webhook",
        "method": "POST"
      },
      "user_key": "***...a1b2"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Query Parameters

​
page
integer
default:1

Page number to retrieve.

Required range: x >= 1
​
page_size
integer
default:100

Number of records per page.

Required range: 1 <= x <= 1000
​
search
string

Filter results by text (case-insensitive substring match).

​
ownership
enum<string>
default:all

Controls which resources are returned based on ownership.

  • all: Returns resources owned by the user and resources shared with them (default, backward compatible).
  • own: Returns only resources created by the authenticated user.
  • shared: Returns only resources shared with the user by others.
Available options:
all,
own,
shared
​
project_id
string<uuid>

Filter results to resources belonging to this project.

Response

List of user monitors

​
total
integer
required

Total number of monitors for this user.

Example:

3

​
page
integer
required

Current page number.

Example:

1

​
page_size
integer
required

Number of monitors per page.

Example:

100

​
total_pages
integer
required

Total number of pages available.

Example:

1

​
monitors
object[]
required

Array of monitor summaries.