Skip to main content
GET
/
v1beta
/
findall
/
runs
/
{findall_id}
/
events
Stream FindAll Events
import requests

url = "https://api.parallel.ai/v1beta/findall/runs/{findall_id}/events"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.json())
{
  "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

Path Parameters

findall_id
string
required

Query Parameters

last_event_id
string | null
timeout
number | null

Response

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:
TitleConst
Typefindall.schema.updated
timestamp
string<date-time>
required

Timestamp of the event.

event_id
string
required

Unique event identifier for the event.

data
object
required

Updated FindAll schema. Response model for FindAll ingest.