Extract (Beta)
Search (Beta)
Monitor
Tasks v1
Tasks (Beta)
from parallel import Parallel
client = Parallel(api_key="API Key")
run_result = client.beta.findall.result(
findall_id="findall_56ccc4d188fb41a0803a935cf485c774",
)
print(f"FindAll run {run_result.run.findall_id} result: {run_result.model_dump_json(indent=2)}"){
"run": {
"findall_id": "<string>",
"status": {
"status": "queued",
"is_active": true,
"metrics": {
"generated_candidates_count": 0,
"matched_candidates_count": 0
},
"termination_reason": "low_match_rate"
},
"generator": "base",
"metadata": {},
"created_at": "<string>",
"modified_at": "<string>"
},
"candidates": [
{
"candidate_id": "<string>",
"name": "<string>",
"url": "<string>",
"match_status": "generated",
"description": "<string>",
"output": {},
"basis": [
{
"field": "<string>",
"reasoning": "<string>",
"citations": [],
"confidence": "low"
}
]
}
],
"last_event_id": "<string>"
}FindAll Run Result
Retrieve the FindAll run result at the time of the request.
from parallel import Parallel
client = Parallel(api_key="API Key")
run_result = client.beta.findall.result(
findall_id="findall_56ccc4d188fb41a0803a935cf485c774",
)
print(f"FindAll run {run_result.run.findall_id} result: {run_result.model_dump_json(indent=2)}"){
"run": {
"findall_id": "<string>",
"status": {
"status": "queued",
"is_active": true,
"metrics": {
"generated_candidates_count": 0,
"matched_candidates_count": 0
},
"termination_reason": "low_match_rate"
},
"generator": "base",
"metadata": {},
"created_at": "<string>",
"modified_at": "<string>"
},
"candidates": [
{
"candidate_id": "<string>",
"name": "<string>",
"url": "<string>",
"match_status": "generated",
"description": "<string>",
"output": {},
"basis": [
{
"field": "<string>",
"reasoning": "<string>",
"citations": [],
"confidence": "low"
}
]
}
],
"last_event_id": "<string>"
}Authorizations
Headers
Path Parameters
Response
Successful Response
Complete FindAll search results.
Represents a snapshot of a FindAll run, including run metadata and a list of candidate entities with their match status and details at the time the snapshot was taken.
FindAll run object.
Show child attributes
Show child attributes
ID of the FindAll run.
Status object for the FindAll run.
Show child attributes
Show child attributes
Status of the FindAll run.
queued, action_required, running, completed, failed, cancelling, cancelled Whether the FindAll run is active
Reason for termination when FindAll run is in terminal status.
low_match_rate, match_limit_met, candidates_exhausted, user_cancelled, error_occurred, timeout Generator for the FindAll run.
base, core, pro, preview Timestamp of the creation of the run, in RFC 3339 format.
Timestamp of the latest modification to the FindAll run result, in RFC 3339 format.
All evaluated candidates at the time of the snapshot.
Show child attributes
Show child attributes
ID of the candidate.
Name of the candidate.
URL that provides context or details of the entity for disambiguation.
Status of the candidate. One of generated, matched, unmatched, discarded.
generated, matched, unmatched, discarded Brief description of the entity that can help answer whether entity satisfies the query.
Results of the match condition evaluations for this candidate. This object contains the structured output that determines whether the candidate matches the overall FindAll objective.
List of FieldBasis objects supporting the output.
Show child attributes
Show child attributes
Name of the output field.
Reasoning for the output field.
List of citations supporting the output field.
Confidence level for the output field. Only certain processors provide confidence levels.
"low"
ID of the last event of the run at the time of the request. This can be used to resume streaming from the last event.