List your LinkedIn connections

Find your connections by name, or list them one window at a time.

connections.list · $0.01 per completed request

When to use it

Use it to check whether you are connected to someone and to get their profile URL.

Field	Type	Notes
`query`	string	Nonblank native name query. Provider matching rules are not exact-name guarantees.
`cursor`	string	Opaque single-use token for a retained Relay-owned list page, bound to account, operation, and invitation direction. Omit initially; use the successor cursor after each successful response. It permits the next observed scroll, not guaranteed new rows. Concurrent use returns CURSOR_IN_USE; consumed, unknown, mismatched, or closed tokens return INVALID_CURSOR. Cancellation/failure closes the affected chain; disconnect, account mismatch, browser closure, and shutdown invalidate network cursors. Restart cannot restore them. No time expiry or collection quota is imposed. Release one idle token with DELETE /v1/cursors/{cursor} (CLI: relay release <cursor>) when finished, or disconnect to close all held pages. Release consumes the token and leaves other pages and the browser connected. Search cursors cannot be released. A failed close with the page still open returns CURSOR_RELEASE_FAILED and allows explicit retry; cancellation after the claim cannot promise rollback. This token contains no provider URL or browser credential and does not replace API authentication.

HTTP, against the local API:

POST http://127.0.0.1:3447/v1/operations/connections.list
Authorization: Bearer <local-token>
Content-Type: application/json

{}

The same request through the CLI, which adds the local token for you:

relay connections --query "Alex Example"

The result has operation, account, data, source and completeness. See Results. Fields in data:

Field	Type	Notes
`query`	string	The normalized native query, present only for queried calls.
`items`	array of object required	Observed connections in provider order.
`items[].profileUrl`	string required	Canonical profile URL identifying this connection.
`items[].name`	string \| null required
`items[].headline`	string \| null required
`items[].connectedDateText`	string \| null required	Displayed connection date text; no timestamp or timezone is inferred.

For the exact contract, run relay schema.

$0.01 per completed request. No subscription. Known failures are not charged. The $5 welcome credit covers 500 requests.