Get Account Details
curl --request GET \
--url https://api.linkupapi.com/v2/accounts/{account_id} \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.linkupapi.com/v2/accounts/{account_id}"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.linkupapi.com/v2/accounts/{account_id}', 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/v2/accounts/{account_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v2/accounts/{account_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.linkupapi.com/v2/accounts/{account_id}")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v2/accounts/{account_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"account_id": "acc_abc123",
"platform": "linkedin",
"account_name": "John Doe",
"is_active": true,
"status": "connected",
"country": "FR",
"created_at": "2025-10-15T08:30:00Z",
"updated_at": "2026-03-20T14:22:00Z",
"sales_nav": {
"connected": true,
"contract_id": "2016220713",
"seat_id": "1545550052",
"connected_at": "2026-03-20T14:22:00Z"
},
"proxy": { "mode": "managed" }
},
"metadata": {
"action": "get_account",
"account_id": "acc_abc123",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ACCOUNT",
"message": "The specified account_id does not exist"
},
"metadata": {
"action": "get_account",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Accounts
Get Account Details
Get detailed information about a specific account
GET
/
v2
/
accounts
/
{account_id}
Get Account Details
curl --request GET \
--url https://api.linkupapi.com/v2/accounts/{account_id} \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.linkupapi.com/v2/accounts/{account_id}"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.linkupapi.com/v2/accounts/{account_id}', 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/v2/accounts/{account_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.linkupapi.com/v2/accounts/{account_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.linkupapi.com/v2/accounts/{account_id}")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.linkupapi.com/v2/accounts/{account_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"account_id": "acc_abc123",
"platform": "linkedin",
"account_name": "John Doe",
"is_active": true,
"status": "connected",
"country": "FR",
"created_at": "2025-10-15T08:30:00Z",
"updated_at": "2026-03-20T14:22:00Z",
"sales_nav": {
"connected": true,
"contract_id": "2016220713",
"seat_id": "1545550052",
"connected_at": "2026-03-20T14:22:00Z"
},
"proxy": { "mode": "managed" }
},
"metadata": {
"action": "get_account",
"account_id": "acc_abc123",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ACCOUNT",
"message": "The specified account_id does not exist"
},
"metadata": {
"action": "get_account",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Retrieve detailed information about a specific account, including its configuration and current status.
This endpoint costs 0 credits.
Header Parameters
string
required
Your API key
Path Parameters
string
required
The unique identifier of the account to retrieve
Response
boolean
Whether the request was successful
object
Show Properties
Show Properties
string
Unique identifier for the account
string
Platform type (e.g. “linkedin”)
string
Display name of the account
boolean
Whether the account is currently active and usable
string
Account status, always in step with
is_active:connected— ready to use (is_active: true)checkpoint_required— waiting on a 2FA code, see Checkpointdisconnected— the LinkedIn session expired; re-authenticate via Connect Account
string
Where the code went, when
checkpoint_required: email, sms, authenticator_app, app_approval or code.string
Masked destination when LinkedIn shows it, e.g.
phone number ending with 23.string
Country code associated with the account
string
ISO 8601 timestamp of when the account was created
string
ISO 8601 timestamp of the last account update
object
State of the account’s Sales Nav seat — same shape as in List Accounts.
Show sales_nav properties
Show sales_nav properties
boolean
Whether the account currently has a usable Sales Nav seat.
string
Sales Nav contract the seat belongs to.
string
The seat within that contract.
string
Last seat activation or refresh. Only when
connected is true.string
Why the seat is unavailable. Only when
connected is false and a seat existed before.string
When the seat was lost. Only when the seat died on its own.
object
{ "mode": "managed" } or { "mode": "custom", "host": "...", "port": 8080 } — see Set Custom Proxy. LinkedIn accounts only.object
{
"success": true,
"data": {
"account_id": "acc_abc123",
"platform": "linkedin",
"account_name": "John Doe",
"is_active": true,
"status": "connected",
"country": "FR",
"created_at": "2025-10-15T08:30:00Z",
"updated_at": "2026-03-20T14:22:00Z",
"sales_nav": {
"connected": true,
"contract_id": "2016220713",
"seat_id": "1545550052",
"connected_at": "2026-03-20T14:22:00Z"
},
"proxy": { "mode": "managed" }
},
"metadata": {
"action": "get_account",
"account_id": "acc_abc123",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
{
"success": false,
"error": {
"code": "INVALID_ACCOUNT",
"message": "The specified account_id does not exist"
},
"metadata": {
"action": "get_account",
"credits_consumed": 0,
"timestamp": "2026-03-24T12:00:00Z"
}
}
Notes
- This endpoint is free and does not consume any credits
- Use this to check if an account is active before making action requests
- Use the dedicated webhook endpoints to configure webhooks for your accounts
Was this page helpful?