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": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "completed",
  "query": "Tech company earnings this quarter.",
  "context": "Focus on revenue and profit margins.",
  "validators": [
    "is_current_quarter",
    "contains_financial_data"
  ],
  "enrichments": [
    "company_name",
    "quarter_identifier",
    "revenue",
    "revenue_change",
    "profit_margin"
  ],
  "duration": "15m",
  "candidate_records": 3200,
  "valid_records": 156,
  "progress_validated": 50,
  "date_range": {
    "start_date": "2025-09-15T00:00:00Z",
    "end_date": "2025-09-30T23:59:59Z"
  },
  "page": 123,
  "total_pages": 123,
  "page_size": 123,
  "all_records": [
    {
      "record_id": "5262823697790152939",
      "record_title": "Oracle Q1 2026 Earnings Exceed Expectations",
      "enrichment": {
        "record_title": "Oracle Q1 2026 Earnings Exceed Expectations",
        "company_name": "Oracle",
        "quarter_identifier": "Q1 2026",
        "revenue": "$14.9 billion",
        "revenue_change": "up 12%",
        "profit_margin": "42% non-GAAP operating margin"
      },
      "citations": [
        {
          "title": "Oracle Reports Strong Q1 2026 Results",
          "link": "https://example.com/article",
          "published_date": "2025-09-26T08:54:20Z"
        }
      ]
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

API key for authentication.

Path Parameters

​
job_id
string<uuid>
required

Unique job identifier returned from the POST /catchAll/submit endpoint.

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.

​
status
string
required

Job status.

Example:

"completed"

​
query
string

Original natural language query.

Example:

"Tech company earnings this quarter."

​
context
string

Context provided with the query.

Example:

"Focus on revenue and profit margins."

​
validators
string[]

List of validation criteria applied to filter results.

Example:
[
  "is_current_quarter",
  "contains_financial_data"
]
​
enrichments
string[]

List of extracted field names generated by the enrichment process. These field names appear in the enrichment object of each record.

Example:
[
  "company_name",
  "quarter_identifier",
  "revenue",
  "revenue_change",
  "profit_margin"
]
​
duration
string

Total time taken to process the job.

Example:

"15m"

​
candidate_records
integer

Number of distinct event clusters identified before validation.

Example:

3200

​
valid_records
integer

Number of validated records extracted.

Example:

156

​
progress_validated
integer

Number of candidate clusters that have been validated during processing.

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

Example:

50

​
date_range
object
​
page
integer

The current page number.

​
total_pages
integer

The total number of pages available.

​
page_size
integer

The number of records per page.

​
all_records
object[]

Array of extracted records with structured data and citations.