Skip to main content
GET
/
catchAll
/
pull
/
{job_id}
Get job results
curl --request GET \
  --url https://catchall.newscatcherapi.com/catchAll/pull/{job_id} \
  --header 'x-api-key: <api-key>'
{
  "job_id": "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
  "query": "Series B funding rounds for SaaS startups",
  "context": "Focus on funding amount and company name",
  "validators": [],
  "enrichments": [],
  "status": "completed",
  "error": null,
  "duration": "1m",
  "candidate_records": 4,
  "valid_records": 3,
  "progress_validated": 4,
  "date_range": {
    "start_date": "2026-02-18T00:00:00Z",
    "end_date": "2026-02-23T00:00:00Z"
  },
  "page": 1,
  "page_size": 2,
  "total_pages": 2,
  "limit": 10,
  "mode": "base",
  "all_records": [
    {
      "record_id": "6983973854314692457",
      "record_title": "VulnCheck Raises $25M Series B Funding",
      "enrichment": {
        "enrichment_confidence": "high",
        "funding_amount": 25000000,
        "funding_currency": "USD",
        "funding_date": "2026-02-17",
        "investee_company": {
          "source_text": "VulnCheck",
          "confidence": 0.99,
          "metadata": {
            "name": "VulnCheck",
            "domain_url": "vulncheck.com",
            "domain_url_confidence": "high"
          }
        },
        "investor_company": {
          "source_text": "Sorenson Capital",
          "confidence": 0.99,
          "metadata": {
            "name": "Sorenson Capital",
            "domain_url": null,
            "domain_url_confidence": null
          }
        }
      },
      "citations": [
        {
          "title": "VulnCheck raises $25M Series B",
          "link": "https://www.msn.com/en-us/money/other/exclusive-vulncheck-raises-25m-funding-to-help-companies-patch-software-bugs/ar-AA1WwdjW",
          "published_date": "2026-02-17T14:01:05Z"
        }
      ]
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Path Parameters

​
job_id
string<uuid>
required

Unique job identifier returned from POST /catchAll/submit.

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

Response

Results retrieved successfully

​
job_id
string<uuid>
required

Job identifier.

​
query
string

Original plain text query.

Example:

"Series B funding rounds for SaaS startups"

​
context
string

Context provided with the query.

Example:

"Focus on funding amount and company name"

​
validators
object[]

Validators applied to filter results.

Example:
[]
​
enrichments
object[]

Enrichment fields used for data extraction.

Example:
[]
​
status
string

Job status.

Example:

"completed"

​
error
string | null

Error message if the job failed. Null for successful jobs.

​
limit
integer

Record limit for this job. Reflects the value specified at submit time, or the plan default if no limit was provided.

Example:

100

​
duration
string

Total time taken to process the job.

Example:

"1m"

​
candidate_records
integer

Total number of distinct event clusters identified. Compare with progress_validated to estimate how many candidates remain unprocessed for job continuation.

Example:

4

​
valid_records
integer

Number of validated records extracted.

Example:

3

​
progress_validated
integer | null

Number of candidate clusters that have been validated during processing.

The system process data in batches. This field tracks how many candidate_records have been checked against validation criteria so far.

Example:

4

​
date_range
object
​
page
integer
default:1

The current page number.

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

The number of records per page.

Required range: x >= 1
​
total_pages
integer
default:0

The total number of pages available.

Required range: x >= 0
​
mode
enum<string>
default:base

Processing mode used for this job.

Available options:
lite,
base
Example:

"base"

​
all_records
object[]

Array of extracted records with structured data and citations.