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>"
}
'import requests
url = "https://api.linkupapi.com/v1/network/invitations"
payload = {
"login_token": "<string>",
"country": "<string>",
"start_page": 123,
"end_page": 123,
"total_results": 123,
"invitation_type": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
login_token: '<string>',
country: '<string>',
start_page: 123,
end_page: 123,
total_results: 123,
invitation_type: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/network/invitations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/network/invitations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'login_token' => '<string>',
'country' => '<string>',
'start_page' => 123,
'end_page' => 123,
'total_results' => 123,
'invitation_type' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/network/invitations"
payload := strings.NewReader("{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/network/invitations")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/network/invitations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
}
}
{
"status": "error",
"message": "Invalid or expired LinkedIn cookie"
}
{
"status": "error",
"message": "Insufficient credits available"
}
Network Management
Get Received Invitations
Retrieve your LinkedIn invitations with pagination support
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>"
}
'import requests
url = "https://api.linkupapi.com/v1/network/invitations"
payload = {
"login_token": "<string>",
"country": "<string>",
"start_page": 123,
"end_page": 123,
"total_results": 123,
"invitation_type": "<string>"
}
headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
login_token: '<string>',
country: '<string>',
start_page: 123,
end_page: 123,
total_results: 123,
invitation_type: '<string>'
})
};
fetch('https://api.linkupapi.com/v1/network/invitations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.linkupapi.com/v1/network/invitations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'login_token' => '<string>',
'country' => '<string>',
'start_page' => 123,
'end_page' => 123,
'total_results' => 123,
'invitation_type' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <x-api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v1/network/invitations"
payload := strings.NewReader("{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.linkupapi.com/v1/network/invitations")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "application/json")
.body("{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v1/network/invitations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"login_token\": \"<string>\",\n \"country\": \"<string>\",\n \"start_page\": 123,\n \"end_page\": 123,\n \"total_results\": 123,\n \"invitation_type\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"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
}
}
}
{
"status": "error",
"message": "Invalid or expired LinkedIn cookie"
}
{
"status": "error",
"message": "Insufficient credits available"
}
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
string
required
Your API key
Body Parameters
string
required
LinkedIn authentication cookie obtained from the login/verify process
string
default:"FR"
Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
integer
Starting page number for pagination mode
integer
Ending page number for pagination mode
integer
default:"10"
Number of invitations to retrieve (used when not in pagination mode)
string
Type of invitations to retrieve (optional)
Response
string
Request status (success/error)
object
Show Properties
Show Properties
integer
Number of invitations returned in this response
integer
Total number of invitations available
array
Show Invitation Object
Show Invitation Object
string
Full name of the person
string
LinkedIn profile URL
string
Professional headline or description
string
Time elapsed since the invitation was sent
integer
Number of days since the invitation was sent (precise to within 7 days for invitations older than a week)
string
Invitation message (if any)
integer
Unique identifier for the invitation
string
Shared secret for the invitation
string
Number of mutual connections
string
Current state of the invitation (e.g., “PENDING”)
string
LinkedIn entity URN for the invitation
string
URL of the person’s profile picture
{
"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
}
}
}
{
"status": "error",
"message": "Invalid or expired LinkedIn cookie"
}
{
"status": "error",
"message": "Insufficient credits available"
}
Notes
- The endpoint supports two modes of operation:
- Pagination mode: Specify both
start_pageandend_pageto fetch specific pages - Total results mode: Use
total_resultsto specify the number of invitations to fetch
- Pagination mode: Specify both
- When using pagination,
end_pagemust be greater than or equal tostart_page - The
messagefield may be null if no message was included with the invitation - The
sent_timeis returned in a human-readable format (e.g., “1 week ago”, “2 months ago”) - Profile pictures URLs are temporary and will expire
Was this page helpful?