API Reference/Endpoints

List all relations

GET/api/linkedin/gateway/users/relations

Pages through everyone the connected account is already a first-degree connection with — its existing LinkedIn network, not people it's still pursuing.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401. The account behind account_id must belong to your key.

Query parameters

FieldTypeDescription

account_id *stringWhich connected account's relations to list.

filterstringOnly return relations whose name matches this text.

cursorstringThe cursor from a previous response, to continue paging.

limitintegerItems per page, 1–1000.

Response fields

FieldTypeDescription

resultobjectitems[], each

{ object, first_name, last_name, headline, public_identifier, public_profile_url, created_at, member_id, member_urn, connection_urn, profile_picture_url? }

, plus cursor — pass it back as cursor to fetch the next page, null on the last one.

Walking a large connections list end to end is exactly the kind of bulk read LinkedIn watches closely — page through it gradually rather than looping through every cursor back-to-back.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.