> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml openapi/zh/parallel.ai.json GET /apis/v1/parallel/findall/runs/{findall_id}/events openapi: 3.1.0 info: description: '' title: Parallel.ai version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/parallel/chat/completions - /apis/v1/parallel/extract - /apis/v1/parallel/findall/ingest - /apis/v1/parallel/findall/runs/{findall_id} - /apis/v1/parallel/findall/runs/{findall_id}/cancel - /apis/v1/parallel/findall/runs/{findall_id}/events - /apis/v1/parallel/findall/runs/{findall_id}/result - /apis/v1/parallel/findall/runs/{findall_id}/schema - /apis/v1/parallel/monitors/{monitor_id} - /apis/v1/parallel/monitors/{monitor_id}/cancel - /apis/v1/parallel/monitors/{monitor_id}/events - /apis/v1/parallel/monitors/{monitor_id}/update - /apis/v1/parallel/tasks/groups - /apis/v1/parallel/tasks/groups/{taskgroup_id} - /apis/v1/parallel/tasks/groups/{taskgroup_id}/events - /apis/v1/parallel/tasks/groups/{taskgroup_id}/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id}/events - /apis/v1/parallel/tasks/runs/{run_id}/input - /apis/v1/parallel/tasks/runs/{run_id}/result - /apis/v1/parallel/v1beta/tasks/runs/{run_id}/events x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:dae9e982424f710c06d9af023168dd26ed96bf5e5b5232e0728c01867d2da7dc x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: parallel.ai x-aisa-catalogs: parallel.ai: title: Parallel.ai description: '' x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/parallel/findall/runs/{findall_id}/events: get: tags: - default summary: Stream FindAll Events description: >- 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. operationId: any_parallel_ai_apis_v1_parallel_findall_runs_fin_63a9dc parameters: - name: parallel-beta in: header required: false schema: anyOf: - type: string - type: 'null' deprecated: true title: Parallel-Beta deprecated: true - name: findall_id in: path required: true schema: type: string title: Findall Id - name: last_event_id in: query required: false schema: anyOf: - type: string - type: 'null' title: Last Event Id - name: timeout in: query required: false schema: anyOf: - type: number - type: 'null' title: Timeout responses: '200': description: Successful Response content: text/event-stream: schema: oneOf: - $ref: >- #/components/schemas/ResponseB67C75A8Feba_FindAllSchemaUpdatedEvent - $ref: >- #/components/schemas/ResponseB67C75A8Feba_FindAllRunStatusEvent - $ref: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent - $ref: '#/components/schemas/ResponseB67C75A8Feba_ErrorEvent' discriminator: propertyName: type mapping: findall.schema.updated: >- #/components/schemas/ResponseB67C75A8Feba_FindAllSchemaUpdatedEvent findall.status: >- #/components/schemas/ResponseB67C75A8Feba_FindAllRunStatusEvent findall.candidate.generated: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent findall.candidate.matched: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent findall.candidate.unmatched: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent findall.candidate.discarded: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent findall.candidate.enriched: >- #/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent error: '#/components/schemas/ResponseB67C75A8Feba_ErrorEvent' title: >- Response 200 Get Findall Events V1Beta Findall Runs Findall Id Events Get example: 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 default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseB67C75A8Feba_FindAllSchemaUpdatedEvent: properties: type: type: string enum: - findall.schema.updated const: findall.schema.updated title: Type description: Event type; always 'findall.schema.updated'. timestamp: type: string format: date-time title: Timestamp description: Timestamp of the event. event_id: type: string title: Event Id description: Unique event identifier for the event. data: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllSchema' description: Updated FindAll schema. type: object required: - type - timestamp - event_id - data title: FindAllSchemaUpdatedEvent description: Event containing full snapshot of FindAll run state. ResponseB67C75A8Feba_FindAllRunStatusEvent: properties: type: type: string enum: - findall.status const: findall.status title: Type description: Event type; always 'findall.status'. timestamp: type: string format: date-time title: Timestamp description: Timestamp of the event. event_id: type: string title: Event Id description: Unique event identifier for the event. data: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllRun' description: Updated FindAll run information. type: object required: - type - timestamp - event_id - data title: FindAllRunStatusEvent description: Event containing status update for FindAll run. ResponseB67C75A8Feba_FindAllCandidateMatchStatusEvent: properties: type: type: string enum: - findall.candidate.generated - findall.candidate.matched - findall.candidate.unmatched - findall.candidate.discarded - findall.candidate.enriched title: Type description: >- Event type; one of findall.candidate.generated, findall.candidate.matched, findall.candidate.unmatched, findall.candidate.discarded, findall.candidate.enriched. timestamp: type: string format: date-time title: Timestamp description: Timestamp of the event. event_id: type: string title: Event Id description: Unique event identifier for the event. data: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllCandidate' description: The candidate whose match status has been updated. type: object required: - type - timestamp - event_id - data title: FindAllCandidateMatchStatusEvent description: Event containing a candidate whose match status has changed. ResponseB67C75A8Feba_ErrorEvent: properties: type: type: string const: error title: Type description: Event type; always 'error'. error: $ref: '#/components/schemas/ResponseB67C75A8Feba_Error' description: Error. type: object required: - type - error title: ErrorEvent description: Event indicating an error. ResponseB67C75A8Feba_FindAllSchema: properties: objective: type: string title: Objective description: Natural language objective of the FindAll run. examples: - Find all AI companies that raised Series A funding in 2024 entity_type: type: string title: Entity Type description: Type of the entity for the FindAll run. match_conditions: items: $ref: '#/components/schemas/ResponseB67C75A8Feba_MatchCondition' type: array title: Match Conditions description: List of match conditions for the FindAll run. enrichments: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllEnrichInput' type: array - type: 'null' title: Enrichments description: List of enrichment inputs for the FindAll run. generator: type: string enum: - base - core - pro - preview title: Generator description: The generator of the FindAll run. default: core match_limit: anyOf: - type: integer - type: 'null' title: Match Limit description: Max number of candidates to evaluate type: object required: - objective - entity_type - match_conditions title: FindAllSchema description: Response model for FindAll ingest. ResponseB67C75A8Feba_FindAllRun: properties: findall_id: type: string title: FindAll ID description: ID of the FindAll run. status: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllRunStatus' description: Status object for the FindAll run. generator: type: string enum: - base - core - pro - preview title: Generator description: Generator for the FindAll run. metadata: anyOf: - additionalProperties: anyOf: - type: string - type: integer - type: number - type: boolean type: object - type: 'null' title: Metadata description: Metadata for the FindAll run. created_at: anyOf: - type: string - type: 'null' title: Created At description: Timestamp of the creation of the run, in RFC 3339 format. modified_at: anyOf: - type: string - type: 'null' title: Modified At description: >- Timestamp of the latest modification to the FindAll run result, in RFC 3339 format. type: object required: - findall_id - status - generator title: FindAllRun description: FindAll run object with status and metadata. ResponseB67C75A8Feba_FindAllCandidate: properties: candidate_id: type: string title: Candidate ID description: ID of the candidate. name: type: string title: Name description: Name of the candidate. url: type: string title: Url description: >- URL that provides context or details of the entity for disambiguation. description: anyOf: - type: string - type: 'null' title: Description description: >- Brief description of the entity that can help answer whether entity satisfies the query. match_status: type: string enum: - generated - matched - unmatched - discarded title: Match Status description: >- Status of the candidate. One of generated, matched, unmatched, discarded. output: anyOf: - additionalProperties: true type: object - type: 'null' title: Output description: >- 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. basis: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_FieldBasis' type: array - type: 'null' title: Basis description: List of FieldBasis objects supporting the output. type: object required: - candidate_id - name - url - match_status title: FindAllCandidate description: >- Candidate for a find all run that may end up as a match. Contains all the candidate's metadata and the output of the match conditions. A candidate is a match if all match conditions are satisfied. ResponseB67C75A8Feba_Error: properties: ref_id: type: string title: Reference ID description: Reference ID for the error. message: type: string title: Message description: Human-readable message. detail: anyOf: - additionalProperties: true type: object - type: 'null' title: Detail description: Optional detail supporting the error. type: object required: - ref_id - message title: Error description: An error message. ResponseB67C75A8Feba_MatchCondition: properties: name: type: string title: Name description: Name of the match condition. description: type: string title: Description description: >- Detailed description of the match condition. Include as much specific information as possible to help improve the quality and accuracy of Find All run results. examples: - >- Company must have SOC2 Type II certification (not Type I). Look for evidence in: trust centers, security/compliance pages, audit reports, or press releases specifically mentioning 'SOC2 Type II'. If no explicit SOC2 Type II mention is found, consider requirement not satisfied. type: object required: - name - description title: MatchCondition description: Match condition model for FindAll ingest. ResponseB67C75A8Feba_FindAllEnrichInput: properties: processor: type: string title: Processor description: Processor to use for the task. default: core output_schema: $ref: '#/components/schemas/ResponseB67C75A8Feba_JsonSchema' description: JSON schema for the enrichment output schema for the FindAll run. mcp_servers: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_McpServer' type: array - type: 'null' title: Mcp Servers description: List of MCP servers to use for the task. type: object required: - output_schema title: FindAllEnrichInput description: Input model for FindAll enrich. ResponseB67C75A8Feba_FindAllRunStatus: properties: status: type: string enum: - queued - action_required - running - completed - failed - cancelling - cancelled title: Status description: Status of the FindAll run. is_active: type: boolean title: Is Active description: Whether the FindAll run is active metrics: $ref: '#/components/schemas/ResponseB67C75A8Feba_FindAllCandidateMetrics' description: Candidate metrics for the FindAll run. termination_reason: anyOf: - type: string enum: - low_match_rate - match_limit_met - candidates_exhausted - user_cancelled - error_occurred - timeout - insufficient_funds - type: 'null' title: Termination Reason description: Reason for termination when FindAll run is in terminal status. type: object required: - status - is_active - metrics title: FindAllRunStatus description: Status object for FindAll run. ResponseB67C75A8Feba_FieldBasis: description: Citations and reasoning supporting one field of a task output. properties: field: description: Name of the output field. title: Field type: string citations: default: [] description: List of citations supporting the output field. items: $ref: '#/components/schemas/ResponseB67C75A8Feba_Citation' title: Citations type: array reasoning: description: Reasoning for the output field. title: Reasoning type: string confidence: anyOf: - type: string - type: 'null' default: null description: >- Confidence level for the output field. Only certain processors provide confidence levels. examples: - low - medium - high title: Confidence required: - field - reasoning title: FieldBasis type: object ResponseB67C75A8Feba_JsonSchema: properties: json_schema: additionalProperties: true type: object title: Json Schema description: A JSON Schema object. Only a subset of JSON Schema is supported. examples: - additionalProperties: false properties: gdp: description: >- GDP in USD for the year, formatted like '$3.1 trillion (2023)' type: string required: - gdp type: object type: type: string const: json title: Type description: The type of schema being defined. Always `json`. default: json type: object required: - json_schema title: JsonSchema description: JSON schema for a task input or output. ResponseB67C75A8Feba_McpServer: properties: type: type: string const: url title: Type description: Type of MCP server being configured. Always `url`. default: url url: type: string title: Url description: URL of the MCP server. headers: anyOf: - additionalProperties: type: string format: password writeOnly: true type: object - type: 'null' title: Headers description: Headers for the MCP server. name: type: string title: Name description: Name of the MCP server. allowed_tools: anyOf: - items: type: string type: array - type: 'null' title: Allowed Tools description: List of allowed tools for the MCP server. type: object required: - url - name title: McpServer description: MCP server configuration. ResponseB67C75A8Feba_FindAllCandidateMetrics: properties: generated_candidates_count: type: integer title: Generated Candidates Count description: Number of candidates that were selected. default: 0 matched_candidates_count: type: integer title: Matched Candidates Count description: Number of candidates that evaluated to matched. default: 0 type: object title: FindAllCandidateMetrics description: Metrics object for FindAll run. ResponseB67C75A8Feba_Citation: description: A citation for a task output. properties: title: anyOf: - type: string - type: 'null' default: null description: Title of the citation. title: Title url: description: URL of the citation. title: Url type: string excerpts: anyOf: - items: type: string type: array - type: 'null' default: null description: >- Excerpts from the citation supporting the output. Only certain processors provide excerpts. title: Excerpts required: - url title: Citation type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.