--- title: "Fetch profiles with corresponding data" method: POST path: "/v3/profiles/fetch" tags: ["profiles"] --- # Fetch profiles with corresponding data `POST /v3/profiles/fetch` Fetch profiles with corresponding data (e.g. lists, tags) ## Headers - `x-authenticate-team` string ## Request body - union - object - `ids` string[], required — The Swarm profile IDs - `linkedin_names` string[] — LinkedIn profile URL slugs - `linkedin_ids` integer[] — LinkedIn numeric profile IDs - `linkedin_entity_ids` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedin_names` string[], required — LinkedIn profile URL slugs - `linkedin_ids` integer[] — LinkedIn numeric profile IDs - `linkedin_entity_ids` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedin_names` string[] — LinkedIn profile URL slugs - `linkedin_ids` integer[], required — LinkedIn numeric profile IDs - `linkedin_entity_ids` string[] — LinkedIn alphanumeric entity IDs - `fields` string[] - object - `ids` string[] — The Swarm profile IDs - `linkedin_names` string[] — LinkedIn profile URL slugs - `linkedin_ids` integer[] — LinkedIn numeric profile IDs - `linkedin_entity_ids` string[], required — LinkedIn alphanumeric entity IDs - `fields` string[] ## Response `200` A list of profiles with corresponding data - object - `results` ProfileV3[], required — List of profiles with corresponding data - `id` string, uuid, required — The unique identifier of the profile - `lists` PipelineV3[] — The lists of the profile - `id` string, uuid, required — The unique identifier of the pipeline - `name` string, required — The name of the pipeline - `status` string, required — The status of the pipeline - `tags` TagV3[] — The tags of the profile - `id` string, uuid, required — The unique identifier of the tag - `name` string, required — The name of the tag - `profile_info` ProfileInfoV3 - `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_seniorities` 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_size` SizeClass - `min` integer — The minimum size of the class - `max` integer — The maximum size of the class - `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` JobV3[] — 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` JobCompanyV3 - `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 - `size` SizeClass - `min` integer — The minimum size of the class - `max` integer — The maximum size of the class - `social_media` CompanySocialMedia[] — 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 - `locations` CompanyLocationV3[] — 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 - `is_primary` boolean — Whether the location is the primary (headquarter) location - `industries` string[] — The industries of the company - `websites` string[] — The websites of the company - `logo_url` string — Company logo URL (CDN) - `title` string — The title of the job - `seniorities` 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', required — Experience status enum - `start_date_confidence` 'validated' | 'low' — Confidence of the experience start date - `current_location` string — The location name of the profile - `location_locality` string — The locality (city) of the profile location - `location_region` string — The region (state) of the profile location - `location_country` string — The country of the profile location - `location_continent` string — The continent of the profile location - `skills` string[] — The skills of the profile - `education` EducationV3[] — The education of the profile - `school` SchoolV3 - `name` string — The name of the school - `location` LocationV3 - `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 - `website` string — The website of the school - `linkedin_url` string — Linkedin profile URL of the school - `linkedin_id` integer — Linkedin numeric id of the school - `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 - `activities` string — The activities of the education - `grade` string — The grade of the education - `description` string — The description of the education - `social_media` ProfileSocialMedia[] — Social media profiles - `network` string — Social media network name - `id` string — Identifier on the social network - `entity_id` string — Persistent entity identifier on the social network - `url` string — Full profile URL - `connections` integer — Number of connections on the social network - `followers` integer — Number of followers on the social network - `slug` string — Slug / handle on the social network - `join_date` string — Date the profile joined the network (YYYY-MM-DD) - `url_status` '' | 'unknown' | 'active' — Status of the resolved URL - `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) - `hiring` boolean — Whether the person is hiring - `open_to_work` boolean — Whether the person is open to work - `found_by` ProfileFoundByV3 — Which of the requested identifiers matched this result - `ids` string[] - `linkedin_names` string[] - `linkedin_ids` integer[] - `linkedin_entity_ids` string[] - `not_found` string[] — Identifiers (ids / linkedin_names / linkedin_ids / linkedin_entity_ids) not found ## Other responses - `400` — Bad request - `401` — Unauthorized - `402` — Payment required - the team's API credit allowance has been exceeded - `403` — Forbidden - `5XX` — Unexpected error ## Changes - **2026-07-26** `55bbdd2aa713` — 1 info - added the new optional `header` request parameter `x-authenticate-team` [Change history](https://skmtc.dev/theswarm/apis/swarm-api/changes/v3/profiles/fetch/post.md) --- [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)