# Get a LinkedIn profile

### Get a LinkedIn profile

`GET /api/v1/linkedin/profiles/{identity}`

Operation ID: `getLinkedinProfile`

Returns a profile by public identifier or user id. Counts against the daily profile view allowance. Returns 429 when the account is at its limit.

**Path parameters**

- `identity` (string, required): User id (ACoAAA…) or public identifier.

**Query parameters**

- `connectedAccountId` (string · uuid, required): Connected account to act as

**200**: LinkedIn profile.

- `profile` (object, required)
  - `publicIdentifier` (string | null, required)
  - `profileUrl` (string | null, required)
  - `firstName` (string | null, required)
  - `lastName` (string | null, required)
  - `fullName` (string | null, required)
  - `headline` (string | null, required)
  - `summary` (string | null, required): The About section of the profile.
  - `location` (string | null, required)
  - `companyName` (string | null, required)
  - `jobTitle` (string | null, required)
  - `imageUrl` (string | null, required)
  - `imageUrlLarge` (string | null, required)
  - `backgroundImageUrl` (string | null, required)
  - `followerCount` (number | null, required)
  - `degree` ("self" | "first" | "second" | "third_plus" | "out_of_network" | "unknown", required)
  - `invitationPending` (boolean, required): An invitation from this account is awaiting an answer.
  - `isConnected` (boolean, required): True for a first-degree connection, who can receive a message.
  - `isOpenProfile` (boolean, required): True when this person has Open Profile, so InMail can reach them without a connection and often without a credit.
  - `workExperience` (object[], required)
  - `education` (object[], required)
  - `skills` (object[], required)
  - `projects` (object[], required)
  - `isHiring` (boolean, required): True when the profile shows the #Hiring badge.
  - `isOpenToWork` (boolean, required): True when the profile shows the #OpenToWork badge.
  - `websites` (string[], required)
  - `throttledSections` (string[], required): Sections LinkedIn held back on this read, such as experience or skills. Their lists are empty even when the person has entries; try again later.
- `remainingUsage` (object, required): Remaining allowance for this action on the connected account across hourly, daily, and weekly windows. Each action type has its own limits.
  - `hour` (integer | null, required): Remaining hourly allowance for this action. Null when this action has no hourly cap.
  - `day` (integer, required): Remaining daily allowance for this action.
  - `week` (integer | null, required): Remaining weekly allowance for this action. Null when this action has no weekly cap.
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload