Retrieve the account's own profile

GETdirect.lempile.com/api/v1/users/me

The connected member: three LinkedIn calls the first time, then kept an hour. Its profile_picture_url is Direct's permanent copy of the member's own picture (see the field).

Authentication

X-API-KEY header·A Lempile Direct key, one per workspace, made in Lempile's dashboard.

Query parameters

account_idstringrequirede.g. 00000000-0000-4000-8000-0000000000a1
The account that reads: a Lempile LinkedIn account id (GET /accounts lists them).

Responses

200

›

application/json

objectstringrequired
AlwaysAccountOwnerProfile
providerstringrequired
AlwaysLINKEDIN
provider_idstringrequired
The account's own LinkedIn provider id (ACo…).
entity_urnstringrequired
object_urnstringrequired
urn:li:member:<number>.
first_namestringrequired
last_namestringrequired
profile_picture_urlstring | nullrequired
The account's own picture (400 px) at a permanent public address on Direct, https://direct.lempile.com/pictures/<token>/<image id>.jpg, instead of LinkedIn's link, which expires about three weeks after it's read. No key is needed to load it (the token can't be guessed). The address stays the same while the photo is the same and changes when the member changes their photo (LinkedIn's image id is in it); an older address answers 302 to the newest. null when the member has no photo. LinkedIn's own link only until Direct has kept a copy (its first read of the account).
public_profile_urlstringrequired
public_identifierstringrequired
emailstringrequired
The account's email address on LinkedIn, or empty.
premiumbooleanrequired
open_profilebooleanrequired
organizationsarray of objectrequired
Always [].
recruiternullrequired
sales_navigatornullrequired
headlinestring
occupationstring
locationstring

400

A required parameter missing (errors/missing_parameters), or one that isn't valid (errors/invalid_parameters, errors/invalid_url, errors/content_too_large).

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

401

errors/missing_credentials: the X-API-KEY header is missing, wrong or revoked. errors/disconnected_account: LinkedIn signed the account out (or asks it for a security check); reconnect it.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

404

errors/resource_not_found: an unknown or removed account, an account of another workspace (answered exactly the same), or nothing on LinkedIn with this id.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

429

errors/too_many_requests: LinkedIn asked the account to slow down (it rests 15 minutes), its daily calls or writes are used up, or it's busy with other calls. Wait retry_after seconds.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

500

errors/provider_error: LinkedIn answered something Direct couldn't read (nothing was written). errors/unexpected_error: Direct failed.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

503

errors/network_down: the account's proxy or browser server didn't answer. Nothing was sent.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

504

errors/request_timeout: LinkedIn didn't answer in time. On a write: an unknown outcome (it may have been sent); it's never retried and its Idempotency-Key never writes again.

›

application/json

titlestringrequired
A short title, e.g. Too many requests.
detailstringrequired
What happened, in plain words. Never an account's data.
typestringrequired
Unipile's error type: errors/<kind>. Branch on this, not on detail.
statusintegerrequired
The HTTP status again.
retry_afterinteger
Seconds to wait before trying this account again. Only on 429; the Retry-After header carries the same value.

Was this page helpful?