bannerColor WARNING_YELLOW templateName stackForums

Connections API

The Connections API returns a list of 1st degree connections for a user who has granted access to his/her account. You can control the fields you want to have returned and the number of connections returned for each call.

Usage

  • You must use an access token to make an authenticated call on behalf of a user
  • For 1st degree connections, you may only retrieve profile fields available with the r_basicprofile member permission
  • You cannot "browse connections." That is, you can only get the connections of the user who granted your application access. You cannot get connections of that user's connections (2nd degree connections).
  • You may never store data returned from the Connections API.

Permissions
This API requires the following permissions (see Member Permissions)

Permissions Description
r_network Required to retrieve 1st degree connections

Throttle Limits
Please reference the limits applied to this API

URL

Fields

Since the objects returned are of the "person" type you can access any of the Profile Fields available with the r_basicprofile member permission.

Parameters

If you don't specify any parameters in the URL, you get full details of all connections. Misspelled parameter names are ignored.

In addition to the parameters listed here, you may also specify field selectors to return just the fields you want.

Parameter Required Definition
start No Starting location within the result set for paginated returns. Ranges are specified with a starting index and a number of results (count) to return. The default value for this parameter is 0.
count No Ranges are specified with a starting index and a number of results to return. You may specify any number. Default and max page size is 500. Implement pagination to retrieve more than 500 connections.
modified No Values are updated or new.
modified-since No Value as a Unix time stamp of milliseconds since epoch.

Sample Return XML

A successful call returns an XML document in the following format:

<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<connections total='154'>
  <person>
    <id>
    <first-name>
    <last-name>
    <headline>
    <location>
      <name>
      <country>
        <code>
      </country>
    </location>
    <industry>
    <api-standard-profile-request>
      <url>
      <headers>
        <http-header>
          <name>
          <value>
        </http-header>
      </headers>
    </api-standard-profile-request>
    <site-standard-profile-request>
      <url>
    </site-standard-profile-request>
    <picture-url>
  </person>
</connections>

Finding New Connections

If your application iteratively polls to find the latest set of a member's connections, please make a call like:

Where modified-since is the time you last made the request. (In miliseconds since epoch.) This provides you with the most efficient set of results in the least amount of time.

Returned Member URL Resources

For your convenience, the XML returns two URLs that let you easily display a standard profile.

  • api-standard-profile-url is the URL you use to return a standard profile.
  • site-standard-profile-url is URL you use to display a standard profile on LinkedIn.com