---
title: "Retrieve a profile"
method: GET
path: "/api/v1/users/{identifier}"
tags: ["Users"]
---

# Retrieve a profile

`GET /api/v1/users/{identifier}`

Retrieve the profile of a user. Ensure careful implementation of this action and consult provider limits and restrictions: https://developer.unipile.com/docs/provider-limits-and-restrictions

## Path parameters

- `identifier` string, required

## Query parameters

- `linkedin_sections` string[] — A list of profile sections to retrieve detailed information on a LinkedIn profile. LinkedIn may throttle heavy use of full data section requests, so pick only the sections you truly need. Select *_preview to fetch all sections with preview data (first entries as displayed in the LinkedIn profile UI), or * to fetch all sections with full data (not recommended if you’re chaining a lot of profile calls in a short period). You can also combine selectors, for example, `["*_preview", "experience", "skills"]` to get all sections in preview plus experience and skills in full. In the response, you may receive empty sections if LinkedIn is throttling your requests. In such case, the `throttled_sections` field lists the concerned sections. To prevent this, you should add random delay between your calls, and/or not request as many sections as you use to.
- `linkedin_api` 'recruiter' | 'sales_navigator'
- `notify` boolean
- `account_id` string, required

## Response `200`

OK. Request succeeded.

- union
  - object
    - `provider` 'LINKEDIN', required
    - `provider_id` string, required
    - `public_identifier` union, required
      - string
      - unknown
    - `first_name` union, required
      - string
      - unknown
    - `last_name` union, required
      - string
      - unknown
    - `pronoun` string
    - `headline` string, required
    - `summary` string
    - `contact_info` object
      - `emails` string[]
      - `phones` string[]
      - `adresses` string[]
      - `socials` object[]
        - `type` string, required
        - `name` string, required
    - `birthdate` object
      - `month` number, required
      - `day` number, required
    - `primary_locale` object
      - `country` string, required
      - `language` string, required
    - `location` string
    - `websites` string[], required
    - `creator_website` object
      - `url` string, required
      - `description` string, required
    - `profile_picture_url` string
    - `profile_picture_url_large` string
    - `background_picture_url` string
    - `hashtags` string[]
    - `can_send_inmail` boolean
    - `connected_at` number
    - `is_open_profile` boolean
    - `is_premium` boolean
    - `is_influencer` boolean
    - `is_creator` boolean
    - `is_hiring` boolean
    - `is_open_to_work` boolean
    - `is_saved_lead` boolean
    - `is_crm_imported` boolean
    - `is_relationship` boolean
    - `is_self` boolean
    - `invitation` object
      - `type` union, required
        - 'SENT'
        - 'RECEIVED'
      - `status` union, required
        - 'PENDING'
        - 'IGNORED'
        - 'WITHDRAWN'
    - `work_experience` object[]
      - `id` string
      - `position` string, required
      - `company_id` string
      - `company_url` string
      - `company_picture_url` string
      - `industry` string[]
      - `company` string, required
      - `location` string
      - `description` string
      - `skills` string[], required
      - `current` boolean
      - `status` string
      - `start` union, required
        - string
        - unknown
      - `end` union, required
        - string
        - unknown
    - `work_experience_total_count` number
    - `volunteering_experience` object[]
      - `company` string, required
      - `description` string, required
      - `role` string, required
      - `cause` string, required
      - `start` union, required
        - string
        - unknown
      - `end` union, required
        - string
        - unknown
    - `volunteering_experience_total_count` number
    - `education` object[]
      - `id` string
      - `degree` string
      - `grade` string
      - `description` string
      - `activities` string
      - `school` string, required
      - `school_id` string
      - `school_url` string
      - `school_picture_url` string
      - `skills` string[]
      - `field_of_study` string
      - `start` union, required
        - string
        - unknown
      - `end` union, required
        - string
        - unknown
    - `education_total_count` number
    - `skills` object[]
      - `name` string, required
      - `endorsement_count` number, required
      - `endorsement_id` union, required
        - number
        - unknown
      - `insights` string[], required
      - `endorsed` boolean, required
    - `skills_total_count` number
    - `languages` object[]
      - `name` string, required
      - `proficiency` string
    - `languages_total_count` number
    - `certifications` object[]
      - `name` string, required
      - `organization` string, required
      - `url` string
    - `certifications_total_count` number
    - `projects` object[]
      - `name` string, required
      - `description` string, required
      - `skills` string[], required
      - `start` union, required
        - string
        - unknown
      - `end` union, required
        - string
        - unknown
    - `projects_total_count` number
    - `recommendations` object
      - `received` object[]
        - `text` string, required
        - `caption` string, required
        - `actor` object, required
          - `first_name` string, required
          - `last_name` string, required
          - `provider_id` string, required
          - `headline` string, required
          - `public_identifier` string, required
          - `public_profile_url` string, required
          - `profile_picture_url` string
      - `received_total_count` number
      - `given` object[]
        - `text` string, required
        - `caption` string, required
        - `actor` object, required
          - `first_name` string, required
          - `last_name` string, required
          - `provider_id` string, required
          - `headline` string, required
          - `public_identifier` string, required
          - `public_profile_url` string, required
          - `profile_picture_url` string
      - `given_total_count` number
    - `tags` object[]
      - `id` string, required
      - `name` string, required
    - `notes` object[]
      - `project_id` string, required
      - `content` string, required
      - `created_at` number, required
      - `author` object, required
        - `id` string, required
        - `seat_id` string, required
        - `first_name` string, required
        - `last_name` string, required
        - `public_profile_url` boolean, required
    - `candidate_id` string
    - `recruiting_activity` union[]
      - union
        - object
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'MESSAGE', required
          - `content` string, required
          - `status` union, required
            - 'PENDING'
            - 'ACCEPTED'
            - 'DECLINED'
            - 'AWAITING_REPLY'
        - object
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'NOTE_ADDED' | 'NOTE_EDITED' | 'NOTE_DELETED', required
          - `content` string
        - object
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'LINK_ADDED' | 'LINK_DELETED', required
          - `content` string, required
        - object
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'CANDIDATE_ADDED' | 'CANDIDATE_MOVED', required
          - `project_id` string, required
          - `project_name` string, required
          - `state` string, required
        - object
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'PROFILE_VIEW', required
        - object — We strive to cover all events as they happen.
          - `created_at` string, required
          - `created_by` object, required
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `updated_at` string
          - `updated_by` object
            - `provider_id` string, required
            - `full_name` string, required
            - `picture_url` string
          - `event` 'UNHANDLED_EVENT', required
    - `throttled_sections` union[]
      - union
        - 'experience'
        - 'education'
        - 'languages'
        - 'skills'
        - 'certifications'
        - 'volunteering_experience'
        - 'projects'
        - 'recommendations_received'
        - 'recommendations_given'
    - `follower_count` number
    - `connections_count` number
    - `shared_connections_count` number
    - `network_distance` union
      - 'FIRST_DEGREE'
      - 'SECOND_DEGREE'
      - 'THIRD_DEGREE'
      - 'OUT_OF_NETWORK'
    - `public_profile_url` string
    - `object` 'UserProfile', required
  - object
    - `provider` 'WHATSAPP', required
    - `id` string, required
    - `is_business` boolean
    - `object` 'UserProfile', required
  - object
    - `provider` 'INSTAGRAM', required
    - `provider_id` string, required
    - `provider_messaging_id` string
    - `public_identifier` string, required
    - `full_name` string, required
    - `profile_picture_url` string
    - `profile_picture_url_large` string
    - `biography` string
    - `category` string
    - `followers_count` number, required
    - `mutual_followers_count` number, required
    - `following_count` number, required
    - `posts_count` number, required
    - `profile_type` union, required
      - 'PERSONNAL'
      - 'BUSINESS'
      - 'PROFESSIONNAL'
    - `is_verified` boolean, required
    - `is_private` boolean, required
    - `external_links` string[], required
    - `relationship_status` object, required
      - `following` boolean, required
      - `followed_by` boolean, required
      - `has_sent_invitation` boolean, required
      - `has_received_invitation` boolean, required
    - `business` object
      - `category` union, required
        - string
        - unknown
      - `address_street` union, required
        - string
        - unknown
      - `address_city` union, required
        - string
        - unknown
      - `address_zipcode` union, required
        - string
        - unknown
      - `phone_number` union, required
        - string
        - unknown
      - `email` union, required
        - string
        - unknown
    - `object` 'UserProfile', required
  - object
    - `provider` 'TELEGRAM', required
    - `provider_id` string, required
    - `self` union
      - boolean
      - unknown
    - `contact` union
      - boolean
      - unknown
    - `mutual_contact` union
      - boolean
      - unknown
    - `deleted` union
      - boolean
      - unknown
    - `bot` union
      - boolean
      - unknown
    - `verified` union
      - boolean
      - unknown
    - `restricted` union
      - boolean
      - unknown
    - `fake` union
      - boolean
      - unknown
    - `premium` union
      - boolean
      - unknown
    - `close_friend` union
      - boolean
      - unknown
    - `first_name` union
      - string
      - unknown
    - `last_name` union
      - string
      - unknown
    - `username` union
      - string
      - unknown
    - `phone` union
      - string
      - unknown
    - `profile_picture_url` string, required
    - `status` union
      - object
        - `name` string, required
        - `expires` number
        - `was_online` number
      - unknown
    - `restriction_reason` union
      - object[]
        - `platform` string, required
        - `reason` string, required
        - `text` string, required
      - unknown
    - `lang_code` union
      - string
      - unknown
    - `object` 'UserProfile', required
  - object
    - `provider` 'TWITTER', required
    - `id` string, required
    - `name` string, required
    - `screen_name` string, required
    - `location` string, required
    - `description` union, required
      - unknown
      - string
    - `url` union, required
      - unknown
      - string
    - `entities` object, required
      - `description` object, required
        - `urls` unknown[], required
          - unknown
    - `protected` boolean, required
    - `verified` boolean, required
    - `followers_count` number, required
    - `friends_count` number, required
    - `listed_count` number, required
    - `favourites_count` number, required
    - `statuses_count` number, required
    - `created_at` string, required
    - `profile_banner_url` union
      - string
      - unknown
    - `profile_image_url_https` string, required
    - `default_profile` boolean, required
    - `default_profile_image` boolean, required
    - `withheld_in_countries` string[], required
    - `followed_by` union
      - unknown
      - boolean
    - `following` union
      - unknown
      - boolean
    - `follow_request_sent` union
      - unknown
      - boolean
    - `has_extended_profile` union
      - unknown
      - boolean
    - `notifications` union
      - unknown
      - boolean
    - `advertiser_account_type` union
      - unknown
      - string
    - `business_profile_state` union
      - unknown
      - string
    - `require_some_consent` union
      - unknown
      - boolean
    - `object` 'UserProfile', required

## Other responses

- `401` — ## Unauthorized ### Disconnected account The account appears to be disconnected from the provider service. undefined
- `403` — ## Forbidden ### Insufficient permissions - Type: "errors/insufficient_permissions" Valid authentication but insufficient permissions to perform the request. ### Account restricted - Type: "errors/account_restricted" Access to this account has been restricted by the provider. ### Account mismatch - Type: "errors/account_mismatch" This action cannot be done with your account. ### Unknown authentication context - Type: "errors/unknown_authentication_context" An additional step seems necessary to complete login. Please connect to provider with your browser to find out more, then retry authentication. ### Session mismatch - Type: "errors/session_mismatch" Token User id does not match client session id. ### Feature not subscribed - Type: "errors/feature_not_subscribed" The requested feature has either not been subscribed or not been authenticated properly. ### Subscription required - Type: "errors/subscription_required" The action you're trying to achieve requires a subscription to provider's services. ### Resource access restricted - Type: "errors/resource_access_restricted" You don't have access to this resource. ### Action required - Type: "errors/action_required" An additional step seems necessary. Complete authentication on the provider's native application and try again.
- `404` — ## Not Found ### Resource not found. The requested resource were not found. User not found
- `422` — ## Unprocessable Entity ### Invalid account Provided account is not designed for this feature. undefined
- `429` — ## Too Many Requests ### Too many requests The provider cannot accept any more requests at the moment. Please try again later. undefined
- `500` — ## Internal Server Error ### Unexpected error - Type: "errors/unexpected_error" Something went wrong. {{moreDetails}} ### Provider error - Type: "errors/provider_error" The provider is experiencing operational problems. Please try again later. ### Authentication intent error - Type: "errors/authentication_intent_error" The current authentication intent was killed after failure. Please start the process again from the beginning.
- `501` — ## Not Implemented ### Missing feature Requested feature is planned but has not been implemented yet. undefined
- `503` — ## Service Unavailable ### Network down Network is down on server side. Please wait a moment and retry. undefined
- `504` — ## Gateway Timeout ### Request timed out - Type: "errors/request_timeout" Request Timeout. Please try again, and if the issue persists, contact support.

---

[API](https://skmtc.net/unipile/apis/unipile-api-reference.md) · [All operations](https://skmtc.net/unipile/apis/unipile-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unipile/unipile-api-reference/revisions/3483a34061f6/schema)