--- title: "Fetch profiles with corresponding data" method: POST path: "/v2/profiles/fetch" tags: ["profiles"] --- # Fetch profiles with corresponding data `POST /v2/profiles/fetch` Fetch profiles with corresponding data (e.g. connections, lists, tags) ## Request body - union - object - `ids` string[], required — The Swarm profile IDs - `linkedinNames` string[] — LinkedIn profile URL slugs - `linkedinIds` integer[] — LinkedIn numeric profile IDs - `linkedinEntityIds` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedinNames` string[], required — LinkedIn profile URL slugs - `linkedinIds` integer[] — LinkedIn numeric profile IDs - `linkedinEntityIds` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedinNames` string[] — LinkedIn profile URL slugs - `linkedinIds` integer[], required — LinkedIn numeric profile IDs - `linkedinEntityIds` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedinNames` string[] — LinkedIn profile URL slugs - `linkedinIds` integer[] — LinkedIn numeric profile IDs - `linkedinEntityIds` string[], required — LinkedIn alphanumeric entity IDs - `fields` string[] ## Response `200` A list of profiles with corresponding data - object - `results` Profile[], required — List of profiles with corresponding data - `id` string, uuid, required — The unique identifier of the profile - `connections` Connection[] — The connections of the profile - `user_id` string, uuid, required — The unique identifier of the user - `user_email` string, required — The email of the user - `user_linkedin_name` string, required — The LinkedIn name of the user - `created_at` string, date-time, required — The creation date of the connection - `sources` Source[], required — The sources of the connection - `origin` string, required — The origin of the source - `network` string, required — The network of the source - `connection_strength` number, float, required — The strength of the connection - `manual_strength` number, float — The manually set strength of the connection - `strength_normalized` integer, required — The normalized strength of the connection - `lists` Pipeline[] — The pipelines of the profile - `id` string, required — The unique identifier of the pipeline - `name` string, required — The name of the pipeline - `status` string, required — The status of the pipeline - `notes` Note[] — The notes of the profile - `id` string, required — The unique identifier of the note - `content` string, required — The content of the note - `tags` Tag[] — The tags of the profile - `id` string, required — The unique identifier of the tag - `name` string, required — The name of the tag - `profile_info` ProfileInfo - `id` string, uuid, required — The unique identifier of the profile - `full_name` string — The full name of the profile - `first_name` string — The first name of the profile - `last_name` string — The last name of the profile - `headline` string — The title of the current job - `about` string — The industry of the profile - `linkedin_url` string — The LinkedIn URL of the profile - `work_email` string — The work email of the profile - `personal_emails` string[] — The personal emails of the profile - `current_title` string — The title of the current job - `current_function` string — The role of the title in the current job - `current_seniority` string[] — The person's seniority in the current job - `current_company_id` string, uuid — The unique identifier of the company in the current job - `current_company_name` string — The name of the company in the current job - `current_company_logo_url` string — The logo URL of the company in the current job - `current_company_website` string — The website of the company in the current job - `current_company_size` SizeClass - `min` integer — The minimum size of the class - `max` integer — The maximum size of the class - `current_company_industry` string — The industry of the company in the current job - `current_company_location` string — The location name of the company in the current job - `current_company_linkedin_url` string — The LinkedIn URL of the company in the current job - `experience` Job[] — The experience of the profile - `is_current` boolean — Whether the job is primary or not - `company_id` string, uuid — The unique identifier of the company in the job - `company` ProfileCompany - `id` string, uuid — The unique identifier of the company - `canonical_name` string — The canonical name of the company - `name` string — The name of the company - `founded` string, date-time — The founding date of the company - `industry` string — The industry of the company - `website` string — The website of the company - `size` SizeClass - `min` integer — The minimum size of the class - `max` integer — The maximum size of the class - `social_media` SocialMedia[] — The networks of the company - `network` string — Social media network name - `id` string — Identifier on the social network - `slug` string — Slug / handle on the social network - `url` string — Full profile URL - `url_status` '' | 'unknown' | 'active' — Status of the resolved URL - `locations` CompanyLocation[] — The locations of the company - `name` string — The name of the location - `city` string — The city of the location - `state` string — The state of the location - `country` string — The country of the location - `street_address` string — The street address of the location - `postal_code` string — The postal code of the location - `headquarter` boolean — Whether the location is the headquarter - `industries` string[] — The industries of the company - `websites` string[] — The websites of the company - `workforce` object - `headcount` integer — Current headcount - `title` string — The title of the job - `seniority` string[] — The person's seniority in the job - `function` string — The role/function in the job - `location` string[] — Job location names - `description` string — The description of the job - `start_date` string, date — The start date of the job - `end_date` string, date — The end date of the job - `status` 'unknown' | 'past' | 'ongoing' — Experience status enum - `current_location` string — The location name of the profile - `other_locations` string[] — The location names of the profile - `skills` string[] — The skills of the profile - `education` Education[] — The education of the profile - `school` School - `name` string — The name of the school - `location` Location - `name` string — The name of the location - `city` string — The city of the location - `state` string — The state of the location - `country` string — The country of the location - `street_address` string — The street address of the location - `postal_code` string — The postal code of the location - `website` string — The website of the school - `linkedin_url` string — Linkedin profile URL of the school - `linkedin_id` string — Linkedin numeric id of the school - `social_media` SocialMedia[] — Social media profiles of the school - `network` string — Social media network name - `id` string — Identifier on the social network - `slug` string — Slug / handle on the social network - `url` string — Full profile URL - `url_status` '' | 'unknown' | 'active' — Status of the resolved URL - `start_date` string, date — The start date of the education - `end_date` string, date — The end date of the education - `degrees` string[] — The degrees of the education - `majors` string[] — The majors of the education - `minors` string[] — The minors of the education - `activities` string — The activities of the education - `grade` string — The grade of the education - `description` string — The description of the education - `linkedin_experience_count` integer — Total number of experience entries on LinkedIn - `linkedin_education_count` integer — Total number of education entries on LinkedIn - `social_media` SocialMedia[] — Social media profiles - `network` string — Social media network name - `id` string — Identifier on the social network - `slug` string — Slug / handle on the social network - `url` string — Full profile URL - `url_status` '' | 'unknown' | 'active' — Status of the resolved URL - `investor_data` InvestorData - `description` string — Investor description - `type` string[] — Types (e.g. Angel, VC) - `industry_focus` string[] — Industries of focus - `stage_focus` string[] — Investment stages of focus - `geo_focus` string[] — Geographies of focus - `check_size` string[] — Typical check sizes - `portfolio_companies` object[] — Portfolio companies - `id` string, uuid, required — Portfolio company id - `smart_tags` string[] — AI-generated tags for the profile - `latest_role_change_at` string, date — The date of the latest role change - `latest_company_change_at` string, date — The date of the latest company change - `current_job_updated_at` string, date-time — The update date of current job in the profile - `updated_at` string, date-time — The update date of the profile - `created_at` string, date-time — The creation date of the profile - `last_refresh_at` string, date-time — The last refresh date of the profile - `current_company_websites` string[] — The websites of the company in the current job - `current_company_industries` string[] — The industries of the company in the current job - `certifications` Certification[] — The certifications of the profile - `end_date` string — The end / expiry date of the certification - `name` string — The name of the certification - `organization` string — The issuing organization - `start_date` string — The start / issue date of the certification - `image_url` string — Profile image URL (CDN) - `found_by` FoundBy — Which of the requested identifiers matched this result - `ids` string[] - `linkedinNames` string[] - `linkedinIds` integer[] - `linkedinEntityIds` string[] - `notFound` string[] — Identifiers (ids / linkedinNames / linkedinIds / linkedinEntityIds) not found ## Other responses - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `5XX` — Unexpected error --- [API](https://skmtc.dev/theswarm/apis/swarm-api.md) · [All operations](https://skmtc.dev/theswarm/apis/swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/theswarm/swarm-api/revisions/130f0025ff6c/schema)