# Person role search The Person Role Search endpoint lets you search for individuals based on their roles, titles, time periods, and associated organizations. You can filter by attributes like role title or description, current status, start/end dates, person name, skills, industry, and location. The response returns matching person records along with their role history and linked organization details (e.g. name, domain, founding date). Endpoint: POST /api/{account_id}/datastorage/person_role_search/ Version: 1.0.0 Security: Api-Key ## Path parameters: - `account_id` (integer, required) ## Request fields (application/json): - `page` (integer) - `role_title` (string) This field supports a boolean text search query. - `role_description` (string) This field supports a boolean text search query. - `role_is_current` (boolean) - `role_position_start_date` (string) - `role_position_end_date` (string) - `role_years_on_position_start` (integer) - `role_years_on_position_end` (integer) - `person_name` (string) This field supports a boolean text search query. - `person_headline` (string) This field supports a boolean text search query. - `person_description` (string) This field supports a boolean text search query. - `person_skills` (array) To get a list of IDs use Person skills lookup endpoint. - `person_locations` (array) To get a list of IDs use Locations lookup endpoint. - `person_industries` (array) To get a list of IDs use Industries lookup endpoint. - `person_industries_exclude` (array) To get a list of IDs use Industries lookup endpoint. - `person_linkedin_public_identifiers` (array) LinkedIn person "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/". - `organizations` (array) To get a list of IDs use Organizations lookup endpoint. - `organizations_bulk_domain` (string) - `organization_domains` (array) - `organization_description` (string) This field supports a boolean text search query. - `organization_locations` (array) To get a list of IDs use Locations lookup endpoint. - `organization_industries` (array) To get a list of IDs use Industries lookup endpoint. - `organization_industries_exclude` (array) To get a list of IDs use Industries lookup endpoint. - `organization_keywords` (array) To get a list of IDs use Organization keywords lookup endpoint. - `organization_web_technologies` (array) To get a list of IDs use Web technologies lookup endpoint. - `organization_founded_date_start` (string) - `organization_founded_date_end` (string) - `organization_employees_start` (integer) - `organization_employees_end` (integer) - `organization_revenue_start` (integer) - `organization_revenue_end` (integer) - `organization_domain_rank_start` (integer) - `organization_domain_rank_end` (integer) - `organization_linkedin_public_identifiers` (array) LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/company/!slug!/". - `funding_types` (array) Enum: "angel", "convertible_note", "corporate_round", "debt_financing", "equity_crowdfunding", "grant", "initial_coin_offering", "non_equity_assistance", "post_ipo_debt", "post_ipo_equity", "post_ipo_secondary", "pre_seed", "private_equity", "product_crowdfunding", "secondary_market", "seed", "series_a", "series_b", "series_c", "series_d", "series_e", "series_f", "series_g", "series_h", "series_i", "series_j", "series_unknown", "undisclosed" - `funding_total_start` (integer) - `funding_total_end` (integer) - `funding_event_date_featured_start` (string) - `funding_event_date_featured_end` (string) - `job_post_title` (string) This field supports a boolean text search query. - `job_post_description` (string) This field supports a boolean text search query. - `job_post_is_remote` (boolean,null) - `job_post_is_active` (boolean,null) - `job_post_date_featured_start` (string) - `job_post_date_featured_end` (string) - `job_post_locations` (array) To get a list of IDs use Locations lookup endpoint. - `job_post_locations_exclude` (array) To get a list of IDs use Locations lookup endpoint. - `simple_event_source` (string) * - Product Hunt * - Form C sec.gov * - Form D sec.gov Enum: "product_hunt", "form_c_sec_gov", "form_d_sec_gov" - `simple_event_reason` (string) * - Report released * - Promoted on site Enum: "report_released", "promoted_on_site" - `simple_event_date_featured_start` (string) - `simple_event_date_featured_end` (string) ## Response 200 fields (application/json): - `search_results` (array, required) - `search_results.id` (integer, required) - `search_results.role_title` (string,null) - `search_results.start_date` (string,null) - `search_results.end_date` (string,null) - `search_results.duration` (string,null) - `search_results.description` (string,null) - `search_results.is_current` (boolean, required) - `search_results.organization` (object, required) Organization search result(With prefetch events) serializer. - `search_results.organization.name` (string, required) - `search_results.organization.legal_name` (string, required) - `search_results.organization.website` (string,null) - `search_results.organization.domain` (string,null) - `search_results.organization.domain_rank` (integer,null, required) Domain rank. - `search_results.organization.logo` (string,null) - `search_results.organization.founded_date` (string,null) - `search_results.organization.operating_status` (string,null) - `search_results.organization.employees_range` (string,null) - `search_results.organization.employees_amount` (integer,null) - `search_results.organization.keywords` (array, required) - `search_results.organization.location` (object, required) Serializer for the InnerLocation model. - `search_results.organization.location.osm_locations` (array, required) - `search_results.organization.location.osm_locations.place_type` (string, required) - `search_results.organization.finance_info` (object, required) Serializer for the OrganizationFinanceInfo model. - `search_results.organization.finance_info.revenue` (integer,null) - `search_results.organization.linkedin_info` (object, required) Serializer for the OrganizationLinkedinInfo model. - `search_results.organization.linkedin_info.public_identifier` (string,null) - `search_results.organization.linkedin_info.industry` (object, required) Serializer for the LinkedinIndustry document. - `search_results.organization.linkedin_info.public_profile_url` (string,null, required) Get LinkedIn public profile URL. - `search_results.organization.addresses` (array, required) - `search_results.organization.addresses.street_number` (string,null) - `search_results.organization.addresses.street_name` (string,null) - `search_results.organization.addresses.city` (string,null) - `search_results.organization.addresses.state` (string,null) - `search_results.organization.addresses.postcode` (string,null) - `search_results.organization.addresses.country` (string, required) - `search_results.organization.addresses.summary` (string, required) - `search_results.organization.date_updated` (string, required) - `search_results.organization.found_simple_events` (array, required) Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches. - `search_results.organization.found_simple_events.source` (string, required) * - Product Hunt * - Form C sec.gov * - Form D sec.gov Enum: "product_hunt", "form_c_sec_gov", "form_d_sec_gov" - `search_results.organization.found_simple_events.date_featured` (string, required) - `search_results.organization.found_simple_events.organization_id` (integer, required) - `search_results.organization.found_simple_events.reason` (string, required) * - Report released * - Promoted on site Enum: "report_released", "promoted_on_site" - `search_results.organization.found_simple_events.url` (string, required) - `search_results.organization.found_funding_events` (array, required) Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches. - `search_results.organization.found_funding_events.source` (string, required) * - Crunchbase Enum: "crunchbase" - `search_results.organization.found_funding_events.funding_type` (string, required) - `search_results.organization.found_funding_events.funding_total` (integer, required) - `search_results.organization.found_job_post_events` (array, required) Events will be available in case any event field would be used for the search. In results will be available 30 most recent matches. - `search_results.organization.found_job_post_events.source` (string, required) * - Indeed * - LinkedIn * - AngelList Enum: "indeed", "linkedin", "angellist" - `search_results.organization.found_job_post_events.source_id` (string, required) - `search_results.organization.found_job_post_events.title` (string, required) - `search_results.organization.found_job_post_events.is_remote` (boolean, required) - `search_results.organization.found_job_post_events.is_active` (boolean, required) - `search_results.person` (object, required) Child serializer for the Person model. - `search_results.person.full_name` (string, required) - `search_results.person.first_name` (string, required) - `search_results.person.last_name` (string,null) - `search_results.person.photo` (string,null) - `search_results.person.gender` (string,null) - `search_results.person.headline` (string,null) - `search_results.person.skills` (array, required) - `search_results.person.linkedin_info` (object, required) Serializer for the PersonLinkedinInfo model. - `total_search_results` (integer, required)