List Watchlists Ongoing Monitorings

On this page, you will learn how to list all your monitorings using the API.

GET /monitorings/natural_persons

Results are sorted by creation date, most recent first. A workspace-restricted API key only sees the monitorings of its own workspaces.

Query param	Description	Default
`after`	Pagination cursor. Pass the `next_cursor` value returned in `meta` to get the next page. A `next_cursor` of `null` means there is no further page.	`null`
`limit`	Number of items to return, between 1 and 100.	`100`
`status[eq]`	Filter by status, e.g. `status[eq]=active`. Only accepts a valid status. The plain form `status=active` is not accepted.	`null`
`workspace_id[eq]`	Filter by workspace, e.g. `workspace_id[eq]=<uuid>` (valid UUID).	`null`

Response payload

{
  "meta": {
    "next_cursor": null
  },
  "data": [
    {
      "id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
      "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
      "created_at": "2025-02-12T23:59:59+00:00",
      "updated_at": "2025-02-12T23:59:59+00:00",
      "status": "pending",
      "status_codes": [],
      "first_name": "Emmanuel",
      "last_name": "Macron",
      "born_on": "1977-12-21"
    },
    {
      "id": "08739e2d-35cf-4889-a323-bb103f068529",
      "workspace_id": "9a93d3b5-fb3b-4abf-9e70-26315b33506c",
      "created_at": "2025-02-12T23:59:59+00:00",
      "updated_at": "2025-02-12T23:59:59+00:00",
      "status": "active",
      "status_codes": [],
      "first_name": "Emmanuel",
      "last_name": "Macron",
      "born_on": "1977-12-21"
    }
  ]
}

Updated 1 day ago