View raw JSON
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page number (0-based). Default 0."
},
"person": {
"type": "object",
"properties": {
"roles": {
"type": "array",
"items": {
"enum": [
"founder",
"ceo",
"key_person"
],
"type": "string"
},
"minItems": 1,
"description": "Role at the current employer."
},
"job_titles": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Normalized job-title keys."
},
"contact_types": {
"type": "array",
"items": {
"enum": [
"linkedin",
"email",
"phone",
"twitter"
],
"type": "string"
},
"minItems": 1,
"description": "Contact info the person has on file."
},
"education_schools": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Education institution ids."
},
"linkedin_companies": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Previous or current employer LinkedIn company ids."
}
},
"description": "Person attribute filters.",
"additionalProperties": false
},
"company": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minItems": 1,
"description": "Current-employer UUIDs."
},
"locations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Location permalinks (e.g. 'san-francisco-california'). Resolve names with /location/search first. A value that is not an exact permalink is silently ignored and returns zero rows."
},
"industries": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Industry permalinks (e.g. 'fintech-e067'). Resolve names with /industry/search first. A value that is not an exact permalink is silently ignored and returns zero rows."
},
"ipo_status": {
"type": "array",
"items": {
"enum": [
"public",
"private",
"acquired",
"delisted"
],
"type": "string"
},
"minItems": 1,
"description": "Current-employer IPO status."
},
"latest_deal": {
"type": "object",
"properties": {
"date_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Latest round on or before."
},
"size_max": {
"type": "number",
"minimum": 0,
"description": "Maximum latest-round size (USD)."
},
"size_min": {
"type": "number",
"minimum": 0,
"description": "Minimum latest-round size (USD)."
},
"date_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Latest round on or after."
},
"investor_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minItems": 1,
"description": "Investor UUIDs that participated in the latest round."
},
"financing_types": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"pre": {
"type": "boolean",
"description": "Pre-round modifier (Pre-Seed, Pre-Series A). Default false."
},
"type": {
"enum": [
"SERIES_A",
"SERIES_B",
"SERIES_C",
"SERIES_D",
"SERIES_E",
"SERIES_F",
"SERIES_G",
"SERIES_H",
"SERIES_I",
"SERIES_J",
"SERIES_K",
"SERIES_L",
"SERIES_M",
"SEED",
"SAFE",
"CONVERTIBLE_NOTE",
"EQUITY",
"PREFERRED",
"SECONDARY_MARKET",
"DEBT_FINANCING",
"GRANT",
"NON_EQUITY_ASSISTANCE",
"CROWDFUNDING",
"INITIAL_COIN_OFFERING",
"FUNDING_ROUND"
],
"type": "string",
"description": "Canonical round type (e.g. SERIES_A, SEED) — not the human label."
},
"extension": {
"type": "boolean",
"description": "Extension-round modifier. Default false."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Round types with optional pre/extension modifiers. An invalid type returns 422."
},
"investor_locations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "HQ location permalinks of investors on the latest round."
}
},
"description": "Filters on the current employer's most recent round.",
"additionalProperties": false
},
"search_query": {
"type": "string",
"minLength": 1,
"description": "Semantic search against the person's current employer. Subject to the monthly semantic-search ceiling."
},
"min_relevance": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum similarity threshold (0-1). Only applies with search_query."
},
"employee_count": {
"type": "array",
"items": {
"enum": [
"1-10",
"11-50",
"51-100",
"101-250",
"251-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
],
"type": "string"
},
"minItems": 1,
"description": "Current-employer headcount ranges."
},
"super_categories": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Super-category permalinks (e.g. 'artificial-intelligence-e551'); each automatically includes its related industries. Resolve with /industry/search. A value that is not an exact permalink is silently ignored and returns zero rows."
},
"total_raised_max": {
"type": "number",
"minimum": 0,
"description": "Maximum total raised by the current employer (USD)."
},
"total_raised_min": {
"type": "number",
"minimum": 0,
"description": "Minimum total raised by the current employer (USD)."
},
"investor_people_ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minItems": 1,
"description": "Person UUIDs — keep people whose employer ever raised from any of them as an angel or lead partner."
}
},
"description": "Current-employer filters; setting any requires a current employer.",
"additionalProperties": false
},
"sort_by": {
"enum": [
"most_recent_deal_date",
"total_raised",
"latest_deal_size",
"name",
"total_deal_count",
"deal_count_last_12_months",
"lead_deal_count",
"lead_deal_count_last_12_months",
"filtered_deal_count"
],
"type": "string",
"description": "Sort order. Default most_recent_deal_date; non-applicable keys sort to the bottom."
},
"investor": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minItems": 1,
"description": "Firm (parent investor) UUIDs."
},
"deals": {
"type": "object",
"properties": {
"date_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Deals on or before."
},
"size_max": {
"type": "number",
"minimum": 0,
"description": "Maximum deal size (USD)."
},
"size_min": {
"type": "number",
"minimum": 0,
"description": "Minimum deal size (USD)."
},
"date_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Deals on or after."
},
"industries": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Portfolio company industry permalinks."
},
"ipo_status": {
"type": "array",
"items": {
"enum": [
"public",
"private"
],
"type": "string"
},
"minItems": 1,
"description": "Portfolio company IPO status."
},
"search_query": {
"type": "string",
"minLength": 1,
"description": "Semantic search against the person's portfolio companies. Subject to the monthly semantic-search ceiling."
},
"min_relevance": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Minimum similarity threshold (0-1). Only applies with search_query."
},
"financing_types": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"pre": {
"type": "boolean",
"description": "Pre-round modifier (Pre-Seed, Pre-Series A). Default false."
},
"type": {
"enum": [
"SERIES_A",
"SERIES_B",
"SERIES_C",
"SERIES_D",
"SERIES_E",
"SERIES_F",
"SERIES_G",
"SERIES_H",
"SERIES_I",
"SERIES_J",
"SERIES_K",
"SERIES_L",
"SERIES_M",
"SEED",
"SAFE",
"CONVERTIBLE_NOTE",
"EQUITY",
"PREFERRED",
"SECONDARY_MARKET",
"DEBT_FINANCING",
"GRANT",
"NON_EQUITY_ASSISTANCE",
"CROWDFUNDING",
"INITIAL_COIN_OFFERING",
"FUNDING_ROUND"
],
"type": "string",
"description": "Canonical round type (e.g. SERIES_A, SEED) — not the human label."
},
"extension": {
"type": "boolean",
"description": "Extension-round modifier. Default false."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Round types with optional pre/extension modifiers. An invalid type returns 422."
},
"investment_type": {
"enum": [
"all",
"angel",
"institutional"
],
"type": "string",
"description": "Angel deals, firm deals, or both (default all)."
},
"only_lead_deals": {
"type": "boolean",
"description": "Count only deals the person or firm led. Default false."
},
"super_categories": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Super-category permalinks (e.g. 'artificial-intelligence-e551'); each automatically includes its related industries. Resolve with /industry/search. A value that is not an exact permalink is silently ignored and returns zero rows."
},
"total_raised_max": {
"type": "number",
"minimum": 0,
"description": "Maximum total raised by the portfolio company (USD)."
},
"total_raised_min": {
"type": "number",
"minimum": 0,
"description": "Minimum total raised by the portfolio company (USD)."
},
"min_matching_deals": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Require at least this many matching deals."
},
"portfolio_locations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Portfolio company location permalinks."
},
"portfolio_employee_count": {
"type": "array",
"items": {
"enum": [
"1-10",
"11-50",
"51-100",
"101-250",
"251-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
],
"type": "string"
},
"minItems": 1,
"description": "Portfolio company headcount ranges."
}
},
"description": "Deal-activity and portfolio filters; when set, rows carry filtered_deal_count, filtered_lead_count and filtered_most_recent_date.",
"additionalProperties": false
},
"domains": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Firm domains (max 100)."
},
"locations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Firm HQ location permalinks."
},
"permalinks": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Fundable firm permalinks (max 100)."
},
"linkedin_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Firm LinkedIn URLs (max 100)."
},
"employee_count": {
"type": "array",
"items": {
"enum": [
"1-10",
"11-50",
"51-100",
"101-250",
"251-500",
"501-1000",
"1001-5000",
"5001-10000",
"10001+"
],
"type": "string"
},
"minItems": 1,
"description": "Firm headcount ranges."
},
"crunchbase_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Firm Crunchbase URLs (max 100)."
}
},
"description": "Investor filters; setting any requires the person to be an investor.",
"additionalProperties": false
},
"page_size": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page (1-100). Default 10. Billing is per row returned."
},
"identifiers": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"minItems": 1,
"description": "Person UUIDs."
},
"twitter_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Twitter/X URLs (max 100)."
},
"linkedin_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "LinkedIn person URLs (max 100)."
},
"crunchbase_urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 100,
"minItems": 1,
"description": "Crunchbase person URLs (max 100)."
}
},
"description": "Batch lookup by identifier; rows are still capped by page_size.",
"additionalProperties": false
},
"person_type": {
"enum": [
"company",
"investor",
"any"
],
"type": "string",
"description": "Population: 'company' = people with a current employer (founders, executives, employees); 'investor' = people who invest; 'any' (default) = both."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
