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

client = Parallel()

# Tip: If using Pydantic models, you can generate the schema automatically:
# class CompanyEnrichment(BaseModel):
#     ceo_name: str = Field(description="Name of the CEO")
#     founding_year: str = Field(description="Year the company was founded")
# output_schema = {"type": "json", "json_schema": CompanyEnrichment.model_json_schema()}

schema = client.beta.findall.enrich(
    findall_id="findall_40e0ab8c10754be0b7a16477abb38a2f",
    processor="core",
    output_schema={
        "type": "json",
        "json_schema": {
            "type": "object",
            "properties": {
                "ceo_name": {
                    "type": "string",
                    "description": "Name of the CEO"
                },
                "founding_year": {
                    "type": "string",
                    "description": "Year the company was founded"
                }
            },
            "required": ["ceo_name", "founding_year"],
            "additionalProperties": False
        }
    }
)

print(f"Enrichment added, schema: {schema.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