Talent network
A candidate's recruiter-entered work preferences
curl -X GET "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/preferences" \
-H "Authorization: Bearer $PARAFORM_API_KEY"
{
"candidateUserId": "string",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"salaryMax": 0,
"ote": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED",
"roleType": [
"backend_engineer"
],
"excludedIndustries": [
"venture_capital"
],
"companySizePreferences": [
"< 10 employees"
]
}
}
Required scopes:
Rate limit:
talent_network:readRate limit:
default tier, 120 requests per minute per keycandidateUserId is the handle returned by the membership list, lookup, and batch items.
preferences is null when the candidate has none yet (possible for candidates who entered the network via a role submission). Any candidate owned by an approved member of your agency is addressable. An id owned by another agency answers 404, indistinguishable from a nonexistent candidate.
Path parameters
string
required
Constraints: min length 1.
Response
string
required
object | null
required
Show preferences properties
Show preferences properties
string[]
required
Show 21 allowed values
Show 21 allowed values
new_york, san_francisco, south_bay_area, los_angeles, boston, seattle, texas, chicago, europe, latam, korea, canada, australia, india, uk, washington_dc, asia, denver, florida, minnesota, sacramentostring[]
required
Allowed values:
REMOTE, ON_SITE, HYBRID.integer | null
required
integer | null
required
integer | null
required
string[]
required
Allowed values:
PRE_SEED, SEED, SERIES_A, SERIES_B, SERIES_C, SERIES_D_PLUS, UNKNOWN.string | null
required
Allowed values:
NO_VISA_AUTHORIZATION_NEEDED, HAS_VISA_AUTHORIZATION, NEEDS_NEW_VISA_AUTHORIZATION.string[]
required
Show 83 allowed values
Show 83 allowed values
backend_engineer, frontend_engineer, full_stack_engineer, mobile_engineer, infrastructure_devops_sre, security_engineer, forward_deployed_engineer_solutions_support, robotics_software_engineer, robotics_platform_engineer, sales_solutions_engineer, qa_test_engineering, blockchain_protocol_engineer, developer_relations_advocacy, founding_engineer, product_engineer, embedded_firmware_engineer, mechanical_engineer, electrical_engineer, robotics_hardware_engineer, aerospace_flight_engineer, machine_learning_engineer, robotics_ml_engineer, data_engineer, data_science_analytics, computer_vision_engineer, research_scientist_applied_research, ai_ml_researcher, research_engineer_applied_research, data_scientist_applied_scientist, machine_learning_infrastructure, machine_learning_ops_platform, research_scientist, research_engineer, ai_engineer, product_management, product_design_ux_ui, brand_visual_design, marketing_growth, growth_engineer, growth_marketing, demand_generation, performance_paid_media, lifecycle_crm_email, seo_organic_growth, marketing_ops_analytics, product_marketing, customer_marketing, content_marketing, brand_marketing, social_media_influencer, communications_pr, events_field_marketing, marketing_leadership, founding_marketer_generalist, account_executives_sales, account_management_customer_success, business_development, sales_development_rep, customer_technical_support, content_copywriting, sales_gtm_leadership, partnerships, operations_strategy, robotics_operations_engineer, revenue_operations, finance_accounting, people_talent, chief_of_staff, program_project_management, executive_assistant, data_analyst, engineering_leadership, executive_leadership, clinical_healthcare, legal_compliance_officer, legal_operations, legal_compliance, legal_partner, legal_counsel, legal_associate, legal_in_house_counsel, legal_paralegal, legal_adminstring[]
required
Show 39 allowed values
Show 39 allowed values
venture_capital, logistics, real_estate, marketplace, healthcare, life_sciences, hardware, ai, gaming, fintech, finance, education, ecommerce, devtools, defense, cybersecurity, crypto, data, enterprise, financial_services, government, insurance, law, marketing, media, transportation, environment, robotics, security, construction, manufacturing, consumer, ad_tech, b2b, api_sdk, software_development, creator_economy, edtech, autonomous_vehiclesstring[]
required
Allowed values:
< 10 employees, 10 - 50 employees, 50 - 200 employees, 200 - 1000 employees, > 1000 employees.curl -X GET "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/preferences" \
-H "Authorization: Bearer $PARAFORM_API_KEY"
{
"candidateUserId": "string",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"salaryMax": 0,
"ote": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED",
"roleType": [
"backend_engineer"
],
"excludedIndustries": [
"venture_capital"
],
"companySizePreferences": [
"< 10 employees"
]
}
}
⌘I
curl -X GET "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/preferences" \
-H "Authorization: Bearer $PARAFORM_API_KEY"
{
"candidateUserId": "string",
"preferences": {
"locations": [
"new_york"
],
"workplaceTypes": [
"REMOTE"
],
"salaryMin": 0,
"salaryMax": 0,
"ote": 0,
"idealFundingRounds": [
"PRE_SEED"
],
"visaAuthorization": "NO_VISA_AUTHORIZATION_NEEDED",
"roleType": [
"backend_engineer"
],
"excludedIndustries": [
"venture_capital"
],
"companySizePreferences": [
"< 10 employees"
]
}
}