---
title: "Fetch a refreshed profile"
method: GET
path: "/v2/profiles/fetch/refresh"
tags: ["profiles"]
---

# Fetch a refreshed profile

`GET /v2/profiles/fetch/refresh`

Fetch up-to-date profile data for a given LinkedIn URL slug

## Query parameters

- `linkedinName` string, required

## Response `200`

Refreshed profile data

- 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)

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Profile not found
- `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)
