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"
}
LinkedIn Integration
Get LinkedIn Connection Status
Check whether an identity’s LinkedIn account is connected, and read its current authentication status.
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"
}
{integration} is linkedin on every endpoint documented here. The path is generic; LinkedIn is the integration Edges exposes.Authorizations
API key required for authentication. Add your API key in the X-API-Key header.
Response
Successfully retrieved the account linked to the specified identity and integration.
Available options:
VALID, INVALID, PENDING, LIMIT_REACHED Available options:
MANUAL, EXTENSION, SHARED, API Available options:
BASIC, OAUTH, COOKIES, APIKEY Show child attributes
Show child attributes