Stream FindAll Events

Stream events from a FindAll run.

Args: request: The Shapi request findall_id: The FindAll run ID last_event_id: Optional event ID to resume from. timeout: Optional timeout in seconds. If None, keep connection alive as long as the run is going. If set, stop after specified duration.

GET /v1beta/findall/runs/{findall_id}/events

Python

Python

from parallel import Parallel

client = Parallel()

# Event types: findall.candidate.generated, findall.candidate.matched,
# findall.candidate.unmatched, findall.candidate.discarded,
# findall.candidate.enriched
events = client.beta.findall.events(
    findall_id="findall_56ccc4d188fb41a0803a935cf485c774",
)

for event in events:
    print(f"Event [{event.type}]: {event.model_dump_json()}")

200

{
  "type": "findall.candidate.generated",
  "timestamp": "2025-09-10T21:02:08.626446Z",
  "event_id": "56cee734dbc84172bfc491327f2a0183",
  "data": {
    "candidate_id": "candidate_52e1e30b-4e0a-49d8-82eb-79e64e0ed015",
    "name": "Pika",
    "url": "pika.art",
    "description": "Pika is an AI video generation platform that creates and edits videos from text prompts or images.",
    "match_status": "generated"
  }
}

Authorizations

x-api-key · string · header · required

Headers

parallel-beta · string | null

Path Parameters

findall_id · string · required

Query Parameters

last_event_id · string | null

timeout · number | null

Response

200

text/event-stream

Successful Response

FindAllSchemaUpdatedEvent

FindAllRunStatusEvent

FindAllCandidateMatchStatusEvent

ErrorEvent

Event containing full snapshot of FindAll run state.

type · enum<string> · required

Event type; always 'findall.schema.updated'.

Available options: findall.schema.updated

Allowed value: "findall.schema.updated"

timestamp · string<date-time> · required

Timestamp of the event.

event_id · string · required

Unique event identifier for the event.

data · FindAllSchema · object · required

Updated FindAll schema.

Show child attributes