Skip to main content
POST
/
v1beta
/
findall
/
runs
/
{findall_id}
/
enrich
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

class CompanyEnrichment(BaseModel):
    ceo_name: str = Field(
        description="Name of the CEO"
    )
    founding_year: str = Field(
        description="Year the company was founded"
    )

run = client.beta.findall.enrich(
    findall_id="findall_40e0ab8c10754be0b7a16477abb38a2f",
    processor="core",
    output_schema=CompanyEnrichment
)

print(f"FindAll run {run.findall_id} enriched: {run.model_dump_json(indent=2)}")
{
  "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
}

Authorizations

x-api-key
string
header
required

Headers

parallel-beta
string | null

Path Parameters

findall_id
string
required

Body

application/json

Input model for FindAll enrich.

output_schema
JsonSchema · object
required

JSON schema for the enrichment output schema for the FindAll run.

processor
string
default:core

Processor to use for the task.

mcp_servers
McpServer · object[] | null

List of MCP servers to use for the task.

Response

Successful Response

Response model for FindAll ingest.

objective
string
required

Natural language objective of the FindAll run.

Example:

"Find all AI companies that raised Series A funding in 2024"

entity_type
string
required

Type of the entity for the FindAll run.

match_conditions
MatchCondition · object[]
required

List of match conditions for the FindAll run.

enrichments
FindAllEnrichInput · object[] | null

List of enrichment inputs for the FindAll run.

generator
enum<string>
default:core

The generator of the FindAll run.

Available options:
base,
core,
pro,
preview
match_limit
integer | null

Max number of candidates to evaluate