Skip to content
Docs

Retrieve an account

GETdirect.lempile.com/api/v1/accounts/{account_id}

The account and its status. A status older than 10 minutes (15 while failing) is checked first: one /voyager/api/me through the account's own session.

Authentication

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

Path parameters

  • account_idstringrequired

    The account id.

Responses

200

OK

›

application/json

  • objectstringrequired
    AlwaysAccount
  • typestringrequired
    AlwaysLINKEDIN
  • idstringrequired

    The account id: a Lempile account id. Every other route names it as account_id.

  • namestringrequired

    The member's name on LinkedIn (empty until the first check).

  • created_atstringrequired

    When Direct started serving the account.

  • connection_paramsobjectrequired
    ›Show fields
    • imobjectrequired
      ›Show fields
      • idstringrequired

        The member's LinkedIn provider id (ACo…).

      • publicIdentifierstringrequired

        The member's public identifier (the /in/<…> part).

      • usernamestringrequired

        The member's name.

      • premiumIdnullrequired
      • premiumContractIdnullrequired
      • premiumFeaturesarray of stringrequired

        ["premium"] for a Premium member, else [].

      • organizationsarray of objectrequired

        Always [].

  • groupsarray of objectrequired

    Always [].

  • sourcesarray of objectrequired

    One source, as Unipile's LinkedIn accounts have.

    ›Show fields
    • idstringrequired

      <account id>_MESSAGING.

    • statusstringrequired

      OK: LinkedIn answered the account's last call. CREDENTIALS: LinkedIn refused its session (signed out, a security check). ERROR: the account's browser or proxy gave no working session twice over 10 minutes. CONNECTING: not checked yet.

      One ofOKCONNECTINGCREDENTIALSERROR
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.

Was this page helpful?