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": "job_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,
  "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 /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:

"job_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 candidate records before validation.

Example:

3200

​
valid_records
integer

Number of validated records extracted.

Example:

156

​
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.