Skip to main content
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>'
{
  "auth_type": "OAUTH",
  "setup_source": "API",
  "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"
  }
}

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
​
auth_type
enum<string> | null
Available options:
BASIC,
OAUTH,
COOKIES,
APIKEY
​
setup_source
enum<string> | null
Available options:
MANUAL,
EXTENSION,
SHARED,
API
​
is_shared
boolean
default:false
​
name
string | null
​
uid
string<uuid>
​
integration_permalink
string | null
​
created_at
string<date-time>
default:2025-10-01T00:00:00Z
​
updated_at
string<date-time> | null
​
level
string | null
​
user_uid
string<uuid> | null
​
meta
object | null
​
error
string | null
⌘I