List LinkedIn invitations

Read your received or sent LinkedIn invitations.

invitations.list · $0.01 per completed request

When to use it

Use it to review pending connection, company-follow and newsletter invitations.

Request

Field	Type	Notes
`direction`	"received" \| "sent" required
`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/invitations.list
Authorization: Bearer <local-token>
Content-Type: application/json

{
  "direction": "received"
}

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

relay invitations received

Response

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

Field	Type	Notes
`direction`	"received" \| "sent" required
`items`	array of object required	Every newly observed invitation card in this step, in provider order.
`items[].direction`	"received" \| "sent" required
`items[].kind`	"connection" \| "company_follow" \| "newsletter" \| "unknown" required	Observed card type.
`items[].invitationUrn`	string \| null required	Observed received-invitation URN.
`items[].inviterProfileUrl`	string \| null required	Observed inviter profile, distinct from a company/newsletter subject.
`items[].recipientProfileUrl`	string \| null required	Observed recipient profile.
`items[].targetUrl`	string \| null required	Observed invitation subject URL, including a company or newsletter when present.
`items[].name`	string \| null required
`items[].headline`	string \| null required
`items[].dateText`	string \| null required	Displayed source date text; no timestamp or timezone is inferred.
`items[].noteText`	null required	Full note visibility is unproved because observed notes were clipped.

For the exact contract, run relay schema.

Price

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

Onboard your agent

Other operations

Get a LinkedIn profile · Get a LinkedIn company · List people at a LinkedIn company · Search LinkedIn people · Search LinkedIn companies · List your LinkedIn connections · List LinkedIn conversations · Read a LinkedIn conversation · Send a LinkedIn message · List LinkedIn posts by a member or company · Get a LinkedIn post · List comments on a LinkedIn post · List reactions on a LinkedIn post · Read your LinkedIn feed · List LinkedIn notifications