---
title: "Retrieve a company profile"
method: GET
path: "/api/v1/linkedin/company/{identifier}"
tags: ["LinkedIn Specific"]
---

# Retrieve a company profile

`GET /api/v1/linkedin/company/{identifier}`

Get a company profile from its name or ID.

## Path parameters

- `identifier` string, required

## Query parameters

- `account_id` string, required

## Response `200`

OK. Request succeeded.

- object
  - `object` 'CompanyProfile', required
  - `id` string, required
  - `name` string, required
  - `description` string, required
  - `entity_urn` string, required
  - `public_identifier` string, required
  - `profile_url` string, required
  - `tagline` string
  - `followers_count` number
  - `is_following` boolean
  - `is_employee` boolean
  - `hashtags` object[], required
    - `title` string, required
  - `messaging` object, required
    - `is_enabled` boolean, required
    - `id` string
    - `entity_urn` string
  - `claimed` boolean, required
  - `viewer_permissions` object, required
    - `canMembersInviteToFollow` boolean, required
    - `canReadContentSuggestions` boolean, required
    - `canReadMessages` boolean, required
    - `canUpdateOrganizationProfile` boolean, required
    - `canCreateOrganicShare` boolean, required
    - `canReadAdminDashboard` boolean, required
    - `canReadOrganizationActivity` boolean, required
    - `canEditCurators` boolean, required
    - `canManageOrganizationalPageFollow` boolean, required
    - `canReadOrganizationFollowerAnalytics` boolean, required
    - `canInviteMemberToFollow` boolean, required
    - `canReadOrganizationLeadsAnalytics` boolean, required
    - `canEditPendingAdministrators` boolean, required
    - `canManageMessagingAccess` boolean, required
    - `canSeeEmployeeExperienceAsMember` boolean, required
    - `canEmployeesInviteToFollow` boolean, required
    - `canSeeOrganizationAdministrativePage` boolean, required
    - `canManageAdminRoles` boolean, required
    - `canEditOrganizationDetails` boolean, required
    - `canApproveContent` boolean, required
    - `canViewTeamPerformance` boolean, required
    - `canManageOrganizationSettings` boolean, required
    - `canAccessAdvancedAnalytics` boolean, required
    - `canModerateComments` boolean, required
    - `canCreateAds` boolean, required
    - `canManageAdBudgets` boolean, required
    - `canEditPageTheme` boolean, required
    - `canPublishNewsletters` boolean, required
    - `canEditCustomTabs` boolean, required
    - `canManageIntegrations` boolean, required
    - `canAssignRoles` boolean, required
    - `canApprovePendingMembers` boolean, required
    - `canEditCareerPageSettings` boolean, required
    - `canViewBillingInformation` boolean, required
  - `organization_type` union, required
    - 'PUBLIC_COMPANY'
    - 'EDUCATIONAL'
    - 'SELF_EMPLOYED'
    - 'GOVERNMENT_AGENCY'
    - 'NON_PROFIT'
    - 'SELF_OWNED'
    - 'PRIVATELY_HELD'
    - 'PARTNERSHIP'
    - unknown
  - `locations` object[], required
    - `is_headquarter` boolean, required
    - `country` string, required
    - `city` string, required
    - `postalCode` string
    - `street` string[], required
    - `description` string
    - `area` string
  - `logo` string
  - `localized_description` object[]
  - `localized_name` object[]
  - `localized_tagline` object[]
  - `industry` string[]
  - `activities` string[]
  - `employee_count` number
  - `employee_count_range` object
    - `from` number, required
    - `to` number, required
  - `website` string
  - `foundation_date` string
  - `phone` string
  - `insights` object
    - `employeesCount` object
      - `totalCount` number, required
      - `averageTenure` string, required
      - `employeesCountGraph` object[], required
        - `date` string, required
        - `count` number, required
      - `growthGraph` object[], required
        - `monthRange` number, required
        - `growthPercentage` number, required
  - `acquired_by` object
    - `id` string, required
    - `name` string, required
    - `public_identifier` string, required
    - `profile_url` string, required
  - `crunchbase_funding` object
    - `last_updated_at` string, required
    - `company_url` string, required
    - `rounds` object, required
      - `url` string, required
      - `total_count` number, required
      - `last_round` object, required
        - `announced_on` string, required
        - `url` string, required
        - `funding_type` string, required
        - `investors_count` number, required
        - `lead_investors` object[], required
          - `name` string, required
          - `url` string, required
          - `logo` string
        - `money_raised` object
          - `amount` number, required
          - `currency` string, 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. Company not found
- `422` — ## Unprocessable Entity ### Invalid account Provided account is not designed for this feature. 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.
- `503` — ## Service Unavailable ### No client session - Type: "errors/no_client_session" No client session is currently running. ### No channel - Type: "errors/no_channel" No channel to client session. ### Handler missing - Type: "errors/no_handler" Handler missing for that request. ### Network down - Type: "errors/network_down" Network is down on server side. Please wait a moment and retry. ### Service unavailable - Type: "errors/service_unavailable" Please try again later.
- `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/versions/3483a34061f6/schema)