Get My Profile

curl --request POST \
  --url https://api.linkupapi.com/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params.include_subscription": true
}
'

import requests

url = "https://api.linkupapi.com/v2/profiles"

payload = {
    "account_id": "<string>",
    "action": "<string>",
    "params.include_subscription": True
}
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({
    account_id: '<string>',
    action: '<string>',
    'params.include_subscription': true
  })
};

fetch('https://api.linkupapi.com/v2/profiles', 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/profiles",
  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([
    'account_id' => '<string>',
    'action' => '<string>',
    'params.include_subscription' => true
  ]),
  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/v2/profiles"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\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/v2/profiles")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/profiles")

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  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "public_id": "jane-doe-12345",
    "first_name": "Jane",
    "last_name": "Doe",
    "headline": "Senior Software Engineer at Acme Corp",
    "location": "San Francisco Bay Area",
    "summary": "Engineer focused on distributed systems.",
    "industry": "Computer Software",
    "experience": [
      {
        "id": "2543928369",
        "company": "Acme Corp",
        "title": "Senior Software Engineer",
        "description": "Leading the platform team.",
        "start_date": "1/2023",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme-corp",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo.jpg"
      }
    ],
    "education": [
      {
        "id": "1271230878",
        "school": "Stanford University",
        "degree": "B.S.",
        "field_of_study": "Computer Science",
        "start_date": "9/2014",
        "end_date": "6/2018"
      }
    ],
    "skills": ["Python", "Distributed Systems", "Kubernetes"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
    "email": "jane.doe@example.com",
    "phone": "",
    "website": "",
    "connection_count": 842,
    "is_premium": true,
    "profile_views": 0,
    "post_impressions": 0,
    "subscription": {
      "plan": "Sales Navigator Core",
      "renewal": "Renews on November 23, 2026"
    }
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": true,
  "data": {
    "platform": "whatsapp",
    "phone_number": "33612345678",
    "jid": "33612345678@s.whatsapp.net",
    "name": "Jane Doe",
    "profile_url": "https://wa.me/33612345678",
    "profile_picture_url": "https://pps.whatsapp.net/v/t61/.../profile.jpg",
    "about": "Available",
    "about_set_at": "2025-11-14T12:18:49.000Z",
    "is_business": false,
    "business": null,
    "country": "FR",
    "connected_at": "2026-09-26T14:25:03Z"
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-09-27T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "account_id or account_ids is required"
  },
  "metadata": {
    "action": "get_me",
    "account_id": null,
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

POST

profiles

Get My Profile

curl --request POST \
  --url https://api.linkupapi.com/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params.include_subscription": true
}
'

import requests

url = "https://api.linkupapi.com/v2/profiles"

payload = {
    "account_id": "<string>",
    "action": "<string>",
    "params.include_subscription": True
}
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({
    account_id: '<string>',
    action: '<string>',
    'params.include_subscription': true
  })
};

fetch('https://api.linkupapi.com/v2/profiles', 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/profiles",
  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([
    'account_id' => '<string>',
    'action' => '<string>',
    'params.include_subscription' => true
  ]),
  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/v2/profiles"

	payload := strings.NewReader("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\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/v2/profiles")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/profiles")

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  \"account_id\": \"<string>\",\n  \"action\": \"<string>\",\n  \"params.include_subscription\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "public_id": "jane-doe-12345",
    "first_name": "Jane",
    "last_name": "Doe",
    "headline": "Senior Software Engineer at Acme Corp",
    "location": "San Francisco Bay Area",
    "summary": "Engineer focused on distributed systems.",
    "industry": "Computer Software",
    "experience": [
      {
        "id": "2543928369",
        "company": "Acme Corp",
        "title": "Senior Software Engineer",
        "description": "Leading the platform team.",
        "start_date": "1/2023",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme-corp",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo.jpg"
      }
    ],
    "education": [
      {
        "id": "1271230878",
        "school": "Stanford University",
        "degree": "B.S.",
        "field_of_study": "Computer Science",
        "start_date": "9/2014",
        "end_date": "6/2018"
      }
    ],
    "skills": ["Python", "Distributed Systems", "Kubernetes"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
    "email": "jane.doe@example.com",
    "phone": "",
    "website": "",
    "connection_count": 842,
    "is_premium": true,
    "profile_views": 0,
    "post_impressions": 0,
    "subscription": {
      "plan": "Sales Navigator Core",
      "renewal": "Renews on November 23, 2026"
    }
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": true,
  "data": {
    "platform": "whatsapp",
    "phone_number": "33612345678",
    "jid": "33612345678@s.whatsapp.net",
    "name": "Jane Doe",
    "profile_url": "https://wa.me/33612345678",
    "profile_picture_url": "https://pps.whatsapp.net/v/t61/.../profile.jpg",
    "about": "Available",
    "about_set_at": "2025-11-14T12:18:49.000Z",
    "is_business": false,
    "business": null,
    "country": "FR",
    "connected_at": "2026-09-26T14:25:03Z"
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-09-27T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "account_id or account_ids is required"
  },
  "metadata": {
    "action": "get_me",
    "account_id": null,
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Overview

Returns the full profile data for the account associated with the provided account_id. For a WhatsApp account, returns the linked number’s profile instead: see the 200 (WhatsApp) example. For an iMessage line, returns the line and its sending limits.

This endpoint consumes 1 credit per request. Ignore this if you’re on per-seat pricing: usage is unlimited.

Request

string

required

Your API key for authentication.

string

required

The unique identifier of the account to use.

string

required

Must be "get_me".

boolean

default:"false"

LinkedIn only. Adds subscription to the response: the member’s exact LinkedIn plan, which is_premium alone can’t tell apart (it is true for every paid plan). Adds about 2 seconds.

Response

boolean

Indicates whether the request was successful.

object

The profile data of the authenticated account.

Show data properties

string

Public identifier (vanity name).

string

First name.

string

Last name.

string

Profile headline.

string

Location text.

string

About / bio section.

string

Industry associated with the profile.

array

Work experience entries. Each item: id (to edit it with Update Profile), company, title, description, start_date and end_date formatted as M/YYYY (e.g. "1/2025"; end_date is "" for current roles), company_url, company_logo_url.

array

Education entries. Each item: id, school, degree, field_of_study, start_date, end_date, school_url, school_logo_url.

array

List of skills (array of strings).

string

URL of the profile picture.

string

Email address (when available).

string

Phone number (when available).

string

Website URL (when available).

integer

Number of connections.

boolean

true if the account has any paid LinkedIn plan (Premium, Sales Navigator, Recruiter Lite…).

object | null

Only with include_subscription: true. plan is LinkedIn’s own plan name (e.g. "Sales Navigator Core", "Recruiter Lite"), null without a paid plan; renewal is LinkedIn’s renewal line (e.g. "Renews on November 23, 2026"). subscription is null when LinkedIn’s subscription page could not be read.

integer

Profile views in the last 90 days (Premium analytics; 0 when not exposed).

integer

Post impressions in the last 7 days (Premium analytics; 0 when not exposed).

Show data properties (WhatsApp)

string

Linked number, digits only.

string

WhatsApp display name.

string | null

null when hidden by the owner’s privacy settings.

string | null

”About” text. null when hidden.

boolean

true for a WhatsApp Business number; business then holds category, description, email, website, address.

Show data properties (iMessage)

string

The line’s number, international format.

string

Link that opens a conversation with the line.

object | null

Name and photo shown when a contact saves the number.

object

Where the line stands today: new_conversations_per_24h, new_conversations_last_24h, new_conversations_left, contacts_last_24h / contacts_per_24h, contacts_last_30_days / contacts_per_30_days, reply_rate, warmed_up. See iMessage limits.

object

Show metadata properties

string

The action that was performed ("get_me").

string

The account ID used for the request.

integer

Number of credits consumed (1).

string

ISO 8601 timestamp of the response.

{
  "success": true,
  "data": {
    "public_id": "jane-doe-12345",
    "first_name": "Jane",
    "last_name": "Doe",
    "headline": "Senior Software Engineer at Acme Corp",
    "location": "San Francisco Bay Area",
    "summary": "Engineer focused on distributed systems.",
    "industry": "Computer Software",
    "experience": [
      {
        "id": "2543928369",
        "company": "Acme Corp",
        "title": "Senior Software Engineer",
        "description": "Leading the platform team.",
        "start_date": "1/2023",
        "end_date": "",
        "company_url": "https://linkedin.com/company/acme-corp",
        "company_logo_url": "https://media.licdn.com/dms/image/v2/.../company-logo.jpg"
      }
    ],
    "education": [
      {
        "id": "1271230878",
        "school": "Stanford University",
        "degree": "B.S.",
        "field_of_study": "Computer Science",
        "start_date": "9/2014",
        "end_date": "6/2018"
      }
    ],
    "skills": ["Python", "Distributed Systems", "Kubernetes"],
    "profile_picture_url": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
    "email": "jane.doe@example.com",
    "phone": "",
    "website": "",
    "connection_count": 842,
    "is_premium": true,
    "profile_views": 0,
    "post_impressions": 0,
    "subscription": {
      "plan": "Sales Navigator Core",
      "renewal": "Renews on November 23, 2026"
    }
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

{
  "success": true,
  "data": {
    "platform": "whatsapp",
    "phone_number": "33612345678",
    "jid": "33612345678@s.whatsapp.net",
    "name": "Jane Doe",
    "profile_url": "https://wa.me/33612345678",
    "profile_picture_url": "https://pps.whatsapp.net/v/t61/.../profile.jpg",
    "about": "Available",
    "about_set_at": "2025-11-14T12:18:49.000Z",
    "is_business": false,
    "business": null,
    "country": "FR",
    "connected_at": "2026-09-26T14:25:03Z"
  },
  "metadata": {
    "action": "get_me",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-09-27T10:35:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "account_id or account_ids is required"
  },
  "metadata": {
    "action": "get_me",
    "account_id": null,
    "credits_consumed": 0,
    "timestamp": "2026-03-24T12:00:00Z"
  }
}

Getting Started

Accounts

Profiles

Messaging

Network

Content

Recruiting

Credits

Logs

Email Enrichment

Webhooks (Real-Time)

Get My Profile

Overview

Request

Response