Skip to main content
GET
/
catchAll
/
jobs
/
user
List user jobs
curl --request GET \
  --url https://catchall.newscatcherapi.com/catchAll/jobs/user \
  --header 'x-api-key: <api-key>'
{
  "total": 27,
  "page": 1,
  "page_size": 2,
  "total_pages": 14,
  "jobs": [
    {
      "job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
      "query": "Series B funding rounds for SaaS startups",
      "created_at": "2026-02-24T13:57:56Z",
      "status": "completed",
      "user_key": "***...a1b2",
      "mode": "base"
    },
    {
      "job_id": "8d618890-f9f5-4c97-af17-236136a306a7",
      "query": "Corporate headquarters relocations in the US",
      "created_at": "2026-02-18T20:25:20Z",
      "status": "completed",
      "user_key": "***...a1b2",
      "mode": "base"
    }
  ]
}

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

User jobs retrieved successfully

​
total
integer
required

Total number of jobs for this user.

Example:

47

​
page
integer
required

Current page number.

Example:

1

​
page_size
integer
required

Number of jobs per page.

Example:

10

​
total_pages
integer
required

Total number of pages available.

Example:

5

​
jobs
object[]
required

Array of user jobs on this page.