Skip to main content
POST
/
v1
/
network
/
invitations
Get Received Invitations
curl --request POST \
  --url https://api.linkupapi.com/v1/network/invitations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "login_token": "<string>",
  "country": "<string>",
  "start_page": 123,
  "end_page": 123,
  "total_results": 123,
  "invitation_type": "<string>"
}
'
{
  "status": "success",
  "data": {
    "total_results": 20,
    "total_available_results": 36,
    "invitations": [
      {
        "name": "Sandrine BRUNET",
        "profile_url": "https://www.linkedin.com/in/sandrine-brunet-6a910b94",
        "subtitle": "Cost and Time killer, J'accompagne les entreprises à faire des économies et gagner en temps et sérénité",
        "sent_time": "1 week ago",
        "sent_time_days": 7,
        "message": null,
        "invitation_id": 7331558767219683329,
        "shared_secret": "9gAd0GPh",
        "shared_connections": "13 mutual connections",
        "invitation_state": "PENDING",
        "entity_urn": "urn:li:fsd_invitation:7331558767219683329",
        "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1673297968581?e=1753920000&v=beta&t=vlKK6RCRuU4H3Yp8OUgov5OigmYLxlaeqPUiOVuK0yo"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 2,
      "results_per_page": 10,
      "pages_fetched": 2
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Get a list of your LinkedIn invitations (received) with detailed information about each invitation.
Credit cost varies based on usage mode:
  • Pagination mode: 1 credit per page
  • Total results mode: 1 credit per 10 invitations (rounded up)

​
Header Parameters

​
x-api-key
string
required
Your API key

​
Body Parameters

​
login_token
string
required
LinkedIn authentication cookie obtained from the login/verify process
​
country
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
​
start_page
integer
Starting page number for pagination mode
​
end_page
integer
Ending page number for pagination mode
​
total_results
integer
default:"10"
Number of invitations to retrieve (used when not in pagination mode)
​
invitation_type
string
Type of invitations to retrieve (optional)

​
Response

​
status
string
Request status (success/error)
​
data
object
{
  "status": "success",
  "data": {
    "total_results": 20,
    "total_available_results": 36,
    "invitations": [
      {
        "name": "Sandrine BRUNET",
        "profile_url": "https://www.linkedin.com/in/sandrine-brunet-6a910b94",
        "subtitle": "Cost and Time killer, J'accompagne les entreprises à faire des économies et gagner en temps et sérénité",
        "sent_time": "1 week ago",
        "sent_time_days": 7,
        "message": null,
        "invitation_id": 7331558767219683329,
        "shared_secret": "9gAd0GPh",
        "shared_connections": "13 mutual connections",
        "invitation_state": "PENDING",
        "entity_urn": "urn:li:fsd_invitation:7331558767219683329",
        "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1673297968581?e=1753920000&v=beta&t=vlKK6RCRuU4H3Yp8OUgov5OigmYLxlaeqPUiOVuK0yo"
      }
    ],
    "pagination": {
      "start_page": 1,
      "end_page": 2,
      "results_per_page": 10,
      "pages_fetched": 2
    }
  }
}

​
Notes

  • The endpoint supports two modes of operation:
    1. Pagination mode: Specify both start_page and end_page to fetch specific pages
    2. Total results mode: Use total_results to specify the number of invitations to fetch
  • When using pagination, end_page must be greater than or equal to start_page
  • The message field may be null if no message was included with the invitation
  • The sent_time is returned in a human-readable format (e.g., “1 week ago”, “2 months ago”)
  • Profile pictures URLs are temporary and will expire