---
title: "Get a company page"
method: POST
path: "/v1/actions/get_company"
tags: ["Search"]
---

# Get a company page

`POST /v1/actions/get_company`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/get_company`
- Auth: HTTP bearer

Read one company page.

company also takes the page's name as it appears in its link (linkedin.com/company/<this>).

Docs: https://heyreagent.com/docs/actions/get_company

## Request body

- object
  - `company` string, required: The company: its LinkedIn page URL, its name as it appears in that URL, or its numeric id.
  - `connectionId` string: Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one.

## Response `200`

It worked. Inside result: id, name, description, entityUrn, publicIdentifier, profileUrl, tagline, followersCount, isFollowing, isEmployee, hashtags[].title, messaging.isEnabled, messaging.id, messaging.entityUrn, claimed, viewerPermissions.canMembersInviteToFollow, viewerPermissions.canReadContentSuggestions, viewerPermissions.canReadMessages, viewerPermissions.canUpdateOrganizationProfile, viewerPermissions.canCreateOrganicShare, viewerPermissions.canReadAdminDashboard, viewerPermissions.canReadOrganizationActivity, viewerPermissions.canEditCurators, viewerPermissions.canManageOrganizationalPageFollow, viewerPermissions.canReadOrganizationFollowerAnalytics, viewerPermissions.canInviteMemberToFollow, viewerPermissions.canReadOrganizationLeadsAnalytics, viewerPermissions.canEditPendingAdministrators, viewerPermissions.canManageMessagingAccess, viewerPermissions.canSeeEmployeeExperienceAsMember, viewerPermissions.canEmployeesInviteToFollow, viewerPermissions.canSeeOrganizationAdministrativePage, viewerPermissions.canManageAdminRoles, viewerPermissions.canEditOrganizationDetails, viewerPermissions.canApproveContent, viewerPermissions.canViewTeamPerformance, viewerPermissions.canManageOrganizationSettings, viewerPermissions.canAccessAdvancedAnalytics, viewerPermissions.canModerateComments, viewerPermissions.canCreateAds, viewerPermissions.canManageAdBudgets, viewerPermissions.canEditPageTheme, viewerPermissions.canPublishNewsletters, viewerPermissions.canEditCustomTabs, viewerPermissions.canManageIntegrations, viewerPermissions.canAssignRoles, viewerPermissions.canApprovePendingMembers, viewerPermissions.canEditCareerPageSettings, viewerPermissions.canViewBillingInformation, organizationType, locations[].isHeadquarter, locations[].country, locations[].city, locations[].postalCode, locations[].street, locations[].description, locations[].area, logo, industry, activities, employeeCount, employeeCountRange.from, employeeCountRange.to, website, foundationDate, phone, acquiredBy.id, acquiredBy.name, acquiredBy.publicIdentifier, acquiredBy.profileUrl, crunchbaseFunding.lastUpdatedAt, crunchbaseFunding.companyUrl.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)