Look up a LinkedIn person
One person's LinkedIn relationship with each connected account, read live from LinkedIn: connected or not, any pending invite and when it was sent, and the conversation.
Requires the leads:read scope.
Response. { "person": { providerId, publicIdentifier, name, headline } | null, "accounts": [account, …] }, one entry per connected LinkedIn account.
An account read in full is { account, connectedAs, state: "ok", connected, invite, revnuInvite, messages, messagesTruncated, lastReplyAt }:
- connected is true when this account and the person are first-degree connections.
- invite is the request LinkedIn reports between them, or null: { direction: "sent" | "received" | null, status: "pending" | "ignored" | "withdrawn", at }, where at is when it was sent (epoch milliseconds) if LinkedIn says.
- revnuInvite is Revnu's own record when Revnu sent the invite from this account: { sentAt, acceptedAt, withdrawnAt }. acceptedAt is when Revnu first saw the person connected, not LinkedIn's exact time.
- messages are the newest 50 in the conversation, oldest first: { at, from: "you" | "them", sentBy, kind, text }. sentBy is "agent" when Revnu sent it, "person" when someone replied from Revnu's inbox, and null when it was typed in LinkedIn. messagesTruncated says older messages exist.
- lastReplyAt is the time of their newest message, or null.
An account that could not be read has a state instead: not_connected, needs_reauth (reconnect it in the dashboard), paced with message and retryAt (the account's daily profile-lookup budget is spent), or error with message, including when no profile matches.
| Code | Meaning |
|---|---|
| 400 | profile is missing or is not a LinkedIn profile URL or id. |
| 404 | No connected LinkedIn account has the name in account. |
Request
- Base URL: https://revnu.com
- URL: https://revnu.com/api/v1/linkedin/person
- Auth: HTTP bearer
Query parameters
Required. A linkedin.com/in/ URL, a public id such as tom-park, or a member id (ACoAA…).
The name of one connected LinkedIn account in your workspace. Without it, every connected account is checked.
Response
{ "person": { providerId, publicIdentifier, name, headline } | null, "accounts": [account, …] }, one entry per connected LinkedIn account. An account read in full is { account, connectedAs, state: "ok", connected, invite, revnuInvite, messages, messagesTruncated, lastReplyAt }: - connected is true w
Changes
No recorded changes to this operation across all 1 revision of this API.