Parallel FindAll API

The FindAll API discovers and evaluates entities that match complex criteria from natural language objectives. Submit a high-level goal and the service automatically generates structured match conditions, discovers relevant candidates, and evaluates each against the criteria. Returns comprehensive results with detailed reasoning, citations, and confidence scores for each match decision. Streaming events and webhooks are supported.

OpenAPI Specification

parallel-findall-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Parallel Chat API (Beta) Chat API (Beta) FindAll API
  description: Parallel API
  contact:
    name: Parallel Support
    url: https://parallel.ai
    email: support@parallel.ai
  version: 0.1.2
servers:
- url: https://api.parallel.ai
  description: Parallel API
security:
- ApiKeyAuth: []
tags:
- name: FindAll
  description: The FindAll API discovers and evaluates entities that match complex criteria from natural language objectives. Submit a high-level goal and the service automatically generates structured match conditions, discovers relevant candidates, and evaluates each against the criteria. Returns comprehensive results with detailed reasoning, citations, and confidence scores for each match decision. Streaming events and webhooks are supported.
paths:
  /v1beta/findall/entity-search:
    post:
      tags:
      - FindAll
      summary: Fast Entity Search
      description: 'Return ranked entities matching a natural language objective.


        This endpoint performs a best-effort search optimized for low latency. To keep

        responses fast, it returns a fixed set of attributes and supports queries of

        limited complexity.


        For comprehensive match evaluation and enrichment, use the

        [FindAll API](https://docs.parallel.ai/findall-api/findall-quickstart).'
      operationId: findall_entity_search_v1beta_findall_entity_search_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindAllEntitySearchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllEntitySearchResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nresponse = client.beta.findall.entity_search(\n    entity_type=\"companies\",\n    objective=\"AI startups that raised Series A in 2024\",\n    match_limit=100,\n)\n\nfor entity in response.entities:\n    print(f\"{entity.name}: {entity.url}\")"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst response = await client.beta.findall.entity_search({\n    entity_type: \"companies\",\n    objective: \"AI startups that raised Series A in 2024\",\n    match_limit: 100,\n});\n\nfor (const entity of response.entities) {\n    console.log(`${entity.name}: ${entity.url}`);\n}"
  /v1beta/findall/ingest:
    post:
      tags:
      - FindAll
      summary: Ingest FindAll Run
      description: 'Transforms a natural language search objective into a structured FindAll spec.


        The generated specification serves as a suggested starting point and can be further

        customized by the user.'
      operationId: ingest_findall_run_v1beta_findall_ingest_post
      parameters:
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IngestInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllSchema'
              example:
                objective: Find all AI companies that raised Series A funding in 2024
                entity_type: companies
                match_conditions:
                - name: developing_ai_products_check
                  description: Company must be developing artificial intelligence (AI) products
                - name: raised_series_a_2024_check
                  description: Company must have raised Series A funding in 2024
                generator: core
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nobjective = \"Find all portfolio companies of Khosla Ventures founded after 2020 and CEO names\"\n\ningest = client.beta.findall.ingest(\n    objective=objective,\n)\n\nprint(ingest.model_dump_json(indent=2))"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst objective = 'Find all portfolio companies of Khosla Ventures founded after 2020 and CEO names';\n\nconst ingest = await client.beta.findall.ingest({\n    objective: objective,\n});\n\nconsole.log(JSON.stringify(ingest, null, 2));"
  /v1beta/findall/runs:
    post:
      tags:
      - FindAll
      summary: Create FindAll Run
      description: 'Starts a FindAll run.


        This endpoint immediately returns a FindAll run object with status set to ''queued''.

        You can get the run result snapshot using the GET /v1beta/findall/runs/{findall_id}/result endpoint.

        You can track the progress of the run by:

        - Polling the status using the GET /v1beta/findall/runs/{findall_id} endpoint,

        - Subscribing to real-time updates via the /v1beta/findall/runs/{findall_id}/events

        endpoint,

        - Or specifying a webhook with relevant event types during run creation to receive

        notifications.'
      operationId: findall_runs_v1_v1beta_findall_runs_post
      parameters:
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindAllRunInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllRun'
              example:
                findall_id: findall_56ccc4d188fb41a0803a935cf485c774
                status:
                  status: queued
                  is_active: true
                  metrics:
                    generated_candidates_count: 0
                    matched_candidates_count: 0
                generator: base
                metadata: {}
                created_at: '2025-09-10T21:02:08.626446Z'
                modified_at: '2025-09-10T21:02:08.627376Z'
        '402':
          description: 'Payment required: insufficient credit in account'
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: 'Payment required: insufficient credit in account'
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: 'Unprocessable content: request validation error'
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: 'Unprocessable content: request validation error'
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: 'Too many requests: quota temporarily exceeded'
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: 'Too many requests: quota temporarily exceeded'
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\n# Use the output from the ingest step, or provide your own values\ningest = client.beta.findall.ingest(\n    objective=\"Find all AI companies that raised Series A funding in 2024\",\n)\n\nrun = client.beta.findall.create(\n    objective=ingest.objective,\n    entity_type=ingest.entity_type,\n    match_conditions=[mc.model_dump() for mc in ingest.match_conditions],\n    generator=\"base\",\n    match_limit=10,\n)\n\nprint(f\"FindAll run {run.findall_id} created, response:\")\nprint(run.model_dump_json(indent=2))"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\n// Use the output from the ingest step, or provide your own values\nconst ingest = await client.beta.findall.ingest({\n    objective: \"Find all AI companies that raised Series A funding in 2024\",\n});\n\nconst run = await client.beta.findall.create({\n    objective: ingest.objective,\n    entity_type: ingest.entity_type,\n    match_conditions: ingest.match_conditions,\n    generator: \"base\",\n    match_limit: 10,\n});\n\nconsole.log(`FindAll run ${run.findall_id} created, response:`);\nconsole.log(JSON.stringify(run, null, 2));"
  /v1beta/findall/runs/{findall_id}:
    get:
      tags:
      - FindAll
      summary: Retrieve FindAll Run Status
      description: Retrieve a FindAll run.
      operationId: findall_runs_v1_get_v1beta_findall_runs__findall_id__get
      parameters:
      - name: findall_id
        in: path
        required: true
        schema:
          type: string
          title: Findall Id
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllRun'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nrun = client.beta.findall.retrieve(\n    findall_id=\"findall_56ccc4d188fb41a0803a935cf485c774\",\n)\n\nprint(f\"FindAll run {run.findall_id} status: {run.status.status}\")"
      - lang: TypeScript
        source: 'import Parallel from "parallel-web";


          const client = new Parallel();


          const run = await client.beta.findall.retrieve("findall_56ccc4d188fb41a0803a935cf485c774");


          console.log(`FindAll run ${run.findall_id} status: ${run.status.status}`);'
  /v1beta/findall/runs/{findall_id}/cancel:
    post:
      tags:
      - FindAll
      summary: Cancel FindAll Run
      description: Cancel a FindAll run.
      operationId: cancel_findall_run_v1beta_findall_runs__findall_id__cancel_post
      parameters:
      - name: findall_id
        in: path
        required: true
        schema:
          type: string
          title: Findall Id
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      responses:
        '204':
          description: FindAll run cancelled successfully.
        '404':
          description: FindAll run not found
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: FindAll run not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Cannot cancel a terminated FindAll run
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: Cannot cancel a terminated FindAll run
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nclient.beta.findall.cancel(\n    findall_id=\"findall_56ccc4d188fb41a0803a935cf485c774\",\n)\n\nprint(\"FindAll run cancelled.\")"
      - lang: TypeScript
        source: 'import Parallel from "parallel-web";


          const client = new Parallel();


          await client.beta.findall.cancel("findall_56ccc4d188fb41a0803a935cf485c774");


          console.log("FindAll run cancelled.");'
  /v1beta/findall/runs/{findall_id}/enrich:
    post:
      tags:
      - FindAll
      summary: Add Enrichment to FindAll Run
      description: Add an enrichment to a FindAll run.
      operationId: enrich_findall_run_v1beta_findall_runs__findall_id__enrich_post
      parameters:
      - name: findall_id
        in: path
        required: true
        schema:
          type: string
          title: Findall Id
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindAllEnrichInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllSchema'
              example:
                objective: Find all AI companies that raised Series A funding in 2024
                entity_type: companies
                match_conditions:
                - name: developing_ai_products_check
                  description: Company must be developing artificial intelligence (AI) products
                enrichments:
                - processor: core
                  output_schema:
                    json_schema:
                      type: object
                      properties:
                        ceo_name:
                          type: string
                          description: Name of the current CEO of the company. If the CEO is not publicly known, provide the name of the highest-ranking executive or founder. If no information is available, return null.
                    type: json
                generator: core
                match_limit: 50
        '404':
          description: FindAll run not found
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: FindAll run not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: Validation error
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\n# Tip: If using Pydantic models, you can generate the schema automatically:\n# class CompanyEnrichment(BaseModel):\n#     ceo_name: str = Field(description=\"Name of the CEO\")\n#     founding_year: str = Field(description=\"Year the company was founded\")\n# output_schema = {\"type\": \"json\", \"json_schema\": CompanyEnrichment.model_json_schema()}\n\nschema = client.beta.findall.enrich(\n    findall_id=\"findall_40e0ab8c10754be0b7a16477abb38a2f\",\n    processor=\"core\",\n    output_schema={\n        \"type\": \"json\",\n        \"json_schema\": {\n            \"type\": \"object\",\n            \"properties\": {\n                \"ceo_name\": {\n                    \"type\": \"string\",\n                    \"description\": \"Name of the CEO\"\n                },\n                \"founding_year\": {\n                    \"type\": \"string\",\n                    \"description\": \"Year the company was founded\"\n                }\n            },\n            \"required\": [\"ceo_name\", \"founding_year\"],\n            \"additionalProperties\": False\n        }\n    }\n)\n\nprint(f\"Enrichment added, schema: {schema.model_dump_json(indent=2)}\")"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst schema = await client.beta.findall.enrich(\n    \"findall_40e0ab8c10754be0b7a16477abb38a2f\",\n    {\n        processor: \"core\",\n        output_schema: {\n            type: \"json\",\n            json_schema: {\n                type: \"object\",\n                properties: {\n                    ceo_name: {\n                        type: \"string\",\n                        description: \"Name of the CEO\"\n                    },\n                    founding_year: {\n                        type: \"string\",\n                        description: \"Year the company was founded\"\n                    }\n                },\n                required: [\"ceo_name\", \"founding_year\"],\n                additionalProperties: false\n            }\n        }\n    }\n);\n\nconsole.log(`Enrichment added, schema: ${JSON.stringify(schema, null, 2)}`);"
  /v1beta/findall/runs/{findall_id}/events:
    get:
      tags:
      - FindAll
      summary: Stream FindAll Events
      description: "Stream events from a FindAll run.\n\nArgs:\n    request: The Shapi request\n    findall_id: The FindAll run ID\n    last_event_id: Optional event ID to resume from.\n    timeout: Optional timeout in seconds. If None, keep connection alive\n    as long as the run is going. If set, stop after specified duration."
      operationId: get_findall_events_v1beta_findall_runs__findall_id__events_get
      parameters:
      - 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
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      responses:
        '200':
          description: Successful Response
          content:
            text/event-stream:
              schema:
                oneOf:
                - $ref: '#/components/schemas/FindAllSchemaUpdatedEvent'
                - $ref: '#/components/schemas/FindAllRunStatusEvent'
                - $ref: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                - $ref: '#/components/schemas/ErrorEvent'
                discriminator:
                  propertyName: type
                  mapping:
                    findall.schema.updated: '#/components/schemas/FindAllSchemaUpdatedEvent'
                    findall.status: '#/components/schemas/FindAllRunStatusEvent'
                    findall.candidate.generated: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                    findall.candidate.matched: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                    findall.candidate.unmatched: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                    findall.candidate.discarded: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                    findall.candidate.enriched: '#/components/schemas/FindAllCandidateMatchStatusEvent'
                    error: '#/components/schemas/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
        '404':
          description: FindAll run not found
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: FindAll run not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\n# Event types: findall.candidate.generated, findall.candidate.matched,\n# findall.candidate.unmatched, findall.candidate.discarded,\n# findall.candidate.enriched\nevents = client.beta.findall.events(\n    findall_id=\"findall_56ccc4d188fb41a0803a935cf485c774\",\n)\n\nfor event in events:\n    print(f\"Event [{event.type}]: {event.model_dump_json()}\")"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\n// Event types: findall.candidate.generated, findall.candidate.matched,\n// findall.candidate.unmatched, findall.candidate.discarded,\n// findall.candidate.enriched\nconst events = await client.beta.findall.events(\"findall_56ccc4d188fb41a0803a935cf485c774\");\n\nfor await (const event of events) {\n    console.log(`Event [${event.type}]: ${JSON.stringify(event)}`);\n}"
  /v1beta/findall/runs/{findall_id}/extend:
    post:
      tags:
      - FindAll
      summary: Extend FindAll Run
      description: Extend a FindAll run by adding additional matches to the current match limit.
      operationId: extend_findall_run_v1beta_findall_runs__findall_id__extend_post
      parameters:
      - name: findall_id
        in: path
        required: true
        schema:
          type: string
          title: Findall Id
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindAllExtendInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllSchema'
              example:
                objective: Find all AI companies that raised Series A funding in 2024
                entity_type: companies
                match_conditions:
                - name: developing_ai_products_check
                  description: Company must be developing artificial intelligence (AI) products
                enrichments:
                - processor: core
                  output_schema:
                    json_schema:
                      type: object
                      properties:
                        ceo_name:
                          type: string
                          description: Name of the current CEO of the company. If the CEO is not publicly known, provide the name of the highest-ranking executive or founder. If no information is available, return null.
                    type: json
                generator: core
                match_limit: 50
        '404':
          description: FindAll run not found
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: FindAll run not found
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Additional match limit must be greater than 0
          content:
            application/json:
              example:
                type: error
                error:
                  ref_id: fcb2b4f3-c75e-4186-87bc-caa1a8381331
                  message: Additional match limit must be greater than 0
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nschema = client.beta.findall.extend(\n    findall_id=\"findall_56ccc4d188fb41a0803a935cf485c774\",\n    additional_match_limit=10,\n)\n\nprint(f\"FindAll run extended: {schema.model_dump_json(indent=2)}\")"
      - lang: TypeScript
        source: "import Parallel from \"parallel-web\";\n\nconst client = new Parallel();\n\nconst schema = await client.beta.findall.extend(\n    \"findall_56ccc4d188fb41a0803a935cf485c774\",\n    {\n        additional_match_limit: 10,\n    }\n);\n\nconsole.log(`FindAll run extended: ${JSON.stringify(schema, null, 2)}`);"
  /v1beta/findall/runs/{findall_id}/result:
    get:
      tags:
      - FindAll
      summary: FindAll Run Result
      description: Retrieve the FindAll run result at the time of the request.
      operationId: get_findall_result_v1beta_findall_runs__findall_id__result_get
      parameters:
      - name: findall_id
        in: path
        required: true
        schema:
          type: string
          title: Findall Id
      - name: parallel-beta
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          deprecated: true
          title: Parallel-Beta
          x-stainless-override-schema:
            x-stainless-param: betas
            x-stainless-extend-default: true
            type: array
            description: Optional header to specify the beta version(s) to enable.
            items:
              $ref: '#/components/schemas/ParallelBeta'
        deprecated: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindAllRunResult'
              example:
                run:
                  findall_id: findall_56ccc4d188fb41a0803a935cf485c774
                  status:
                    status: running
                    is_active: true
                    metrics:
                      generated_candidates_count: 1
                      matched_candidates_count: 1
                  generator: base
                  metadata: {}
                  created_at: '2025-09-10T21:02:08.626446Z'
                  modified_at: '2025-09-10T21:02:08.627376Z'
                candidates:
                - candidate_id: candidate_7594eb7c-4f4a-487f-9d0c-9d1e63ec240c
                  name: Cognition AI
                  url: cognition.ai
                  match_status: matched
                  output:
                    developing_ai_products_check: 'yes'
                    raised_series_a_2024_check: 'yes'
                  basis:
                  - field: developing_ai_products_check
                    citations:
                    - title: Cognition - Devin and Cognition AI
                      url: https://cognition.ai/
                      excerpts:
                      - We're the makers of Devin, a collaborative AI teammate that helps ambitious engineering teams achieve more.
                      - An applied AI lab building the future of software engineering
                      - Cognition
                    reasoning: The search results repeatedly state that Cognition AI is an 'applied AI lab building the future of software engineering' and that they developed 'Devin AI', described as the 'world's first AI software engineer'. This directly confirms they are developing AI products.
                    confidence: high
                  - field: raised_series_a_2024_check
                    citations:
                    - title: Cognition Labs Raises $21 Million Series A to Support AI Coding Products
                      url: https://voicebot.ai/2024/04/25/cognition-labs-raises-21-million-series-a-to-support-ai-coding-products/
                      excerpts:
                      - Cognition Labs Raises $21 Million Series A to Support AI Coding Products
                    reasoning: The article from voicebot.ai, dated April 25, 2024, states that Founders Fund led a "$21 million Series A investment" for Cognition Labs. This confirms that Series A funding was raised in 2024.
                    confidence: low
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-code-samples:
      - lang: Python
        source: "from parallel import Parallel\n\nclient = Parallel()\n\nrun_result = client.beta.findall.result(\n    findall_id=\"findall_56ccc4d188fb41a0803a935cf485c774\",\n)\n\nprint(f\"FindAll run {run_result.run.findall_id} re

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/parallel/refs/heads/main/openapi/parallel-findall-api-openapi.yml