Skip to main content
POST
/
v2
/
network
List Invitations
curl --request POST \
  --url https://api.example.com/v2/network \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "count": 123,
    "offset": 123,
    "invitation_type": "<string>"
  }
}
'
{
  "success": true,
  "data": {
    "invitations": [
      {
        "entity_urn": "urn:li:invitation:123456789",
        "shared_secret": "abcdef12-3456-7890-abcd-ef1234567890",
        "sender": {
          "first_name": "Alice",
          "last_name": "Johnson",
          "headline": "Data Scientist",
          "linkedin_url": "https://www.linkedin.com/in/alicejohnson",
          "profile_picture_url": "https://media.licdn.com/dms/image/..."
        },
        "invitation_type": "CONNECTION",
        "sent_time": "1d",
        "sent_time_days": 1
      }
    ],
    "total_results": 1,
    "total_available_results": 26,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": 1,
      "has_more": true,
      "results_per_page": 10,
      "pages_fetched": 1
    }
  },
  "metadata": {
    "action": "list_invitations",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

Overview

Returns a paginated list of pending connection invitations received by the account. Pagination is offset-based — set count for the page size and offset to skip ahead.
This endpoint consumes 1 credit per 50 results returned. LinkedIn returns up to 100 invitations per internal request, so larger count values trigger multiple upstream calls automatically.

Request

x-api-key
string
required
Your API key for authentication.
account_id
string
required
The unique identifier of the account to use.
action
string
required
Must be "list_invitations".
params
object

Response

success
boolean
Indicates whether the request was successful.
data
object
metadata
object
{
  "success": true,
  "data": {
    "invitations": [
      {
        "entity_urn": "urn:li:invitation:123456789",
        "shared_secret": "abcdef12-3456-7890-abcd-ef1234567890",
        "sender": {
          "first_name": "Alice",
          "last_name": "Johnson",
          "headline": "Data Scientist",
          "linkedin_url": "https://www.linkedin.com/in/alicejohnson",
          "profile_picture_url": "https://media.licdn.com/dms/image/..."
        },
        "invitation_type": "CONNECTION",
        "sent_time": "1d",
        "sent_time_days": 1
      }
    ],
    "total_results": 1,
    "total_available_results": 26,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": 1,
      "has_more": true,
      "results_per_page": 10,
      "pages_fetched": 1
    }
  },
  "metadata": {
    "action": "list_invitations",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}