Get an Identity’s Integration

Retrieve the current authentication details and connection status of a identity's integration, e.g. LinkedIn.

curl --request GET \
  --url https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "setup_source": "API",
  "auth_method": "BASIC",
  "is_shared": false,
  "name": "John Doe's Example Integration Account",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "integration_permalink": "example-integration",
  "created_at": "2023-10-01T12:00:00Z",
  "level": "Classic",
  "identity_uid": "5678e456-e89b-12d3-a456-426614174001",
  "meta": {
    "key": "value"
  },
  "status": "VALID",
  "last_synced_at": "2026-05-19T13:25:28.417259"
}

GET

identities

{identity_uid}

integrations

{integration}

Retrieve the current authentication details and connection status of a identity's integration, e.g. LinkedIn.

curl --request GET \
  --url https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/identities/{identity_uid}/integrations/{integration}"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "setup_source": "API",
  "auth_method": "BASIC",
  "is_shared": false,
  "name": "John Doe's Example Integration Account",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "integration_permalink": "example-integration",
  "created_at": "2023-10-01T12:00:00Z",
  "level": "Classic",
  "identity_uid": "5678e456-e89b-12d3-a456-426614174001",
  "meta": {
    "key": "value"
  },
  "status": "VALID",
  "last_synced_at": "2026-05-19T13:25:28.417259"
}

Authorizations

X-API-Key

string

header

required

API key required for authentication. Add your API key in the X-API-Key header.

Path Parameters

identity_uid

string<uuid>

required

integration

string

required

Response

Successfully retrieved the account linked to the specified identity and integration.

identity_uid

string<uuid>

required

status

enum<string>

required

Available options:

VALID,

INVALID,

PENDING,

LIMIT_REACHED

setup_source

enum<string> | null

Available options:

MANUAL,

EXTENSION,

SHARED,

API

auth_method

enum<string> | null

Available options:

BASIC,

OAUTH,

COOKIES,

APIKEY

is_shared

boolean

default:false

name

string | null

uid

string<uuid>

integration_permalink

string | null

created_at

string<date-time>

updated_at

string<date-time> | null

level

string | null

user_uid

string<uuid> | null

API Documentation

Business API

LinkedIn API

Sales Navigator API

Get an Identity’s Integration

Authorizations

Path Parameters

Response