Check relationship status with profile
Check the relationship between your default LinkedIn account and a target profile. Useful for determining which actions are available (message, connect, etc.). `status` is one of four mutually exclusive states: | status | meaning | what you can do | |---|---|---| | `CONNECTED` | 1st-degree connection | message them | | `INVITATION_SENT` | you invited them, still pending | withdraw via `POST /invitations/withdraw` | | `INVITATION_RECEIVED` | they invited you, waiting on you | accept/ignore via `POST /invitations/received/respond` | | `NOT_CONNECTED` | no relationship | invite via `POST /connections/invite` | `INVITATION_RECEIVED` is NOT a connection: the person is still 2nd/3rd degree and cannot be messaged. Check `status`, not just `connected`.
/relationship/{profileId}Code Examples
curl -X GET 'https://api.connectsafely.ai/linkedin/relationship/<profileId>' \ -H 'Authorization: Bearer <your_api_key>'Check the relationship between your default LinkedIn account and a target profile. Useful for determining which actions are available (message, connect, etc.).
status is one of four mutually exclusive states:
| status | meaning | what you can do |
|---|---|---|
CONNECTED | 1st-degree connection | message them |
INVITATION_SENT | you invited them, still pending | withdraw via POST /invitations/withdraw |
INVITATION_RECEIVED | they invited you, waiting on you | accept/ignore via POST /invitations/received/respond |
NOT_CONNECTED | no relationship | invite via POST /connections/invite |
INVITATION_RECEIVED is NOT a connection: the person is still 2nd/3rd degree and cannot be messaged. Check status, not just connected.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
profileId | path | Yes | string | LinkedIn profile vanity URL slug (the part after linkedin.com/in/, e.g., "john-doe-123") |
Request Body
No request body.
Responses
| Status | Description |
|---|---|
| 200 | Relationship status retrieved successfully |
| 404 | Profile not found |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
connected | boolean | Whether you are 1st-degree connected. False while an invitation in either direction is still pending. |
invitationSent | boolean | You invited them and they have not responded |
invitationReceived | boolean | They invited YOU and you have not responded. They are not a connection yet and cannot be messaged. |
status | string | Connection status — exactly one of the four states; see the endpoint description. |
profileUrn | string | LinkedIn profile URN of the target user |
accountId | string | LinkedIn account ID used for the check |
200 Example
{
"connected": false,
"invitationSent": false,
"invitationReceived": false,
"status": "NOT_CONNECTED",
"profileUrn": "urn:li:fsd_profile:ACoAAA24A-MBVEvT49xpVF2gnWrhvmUIPDJshSM",
"accountId": "acc_12345"
}404 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string | |
success | boolean |
404 Example
{
"error": "LinkedIn profile not found: invalid-profile-id",
"success": false
}Withdraw a sent connection invitation
Withdraws a pending connection invitation that was previously sent to a LinkedIn user. Only the profileId is required - other fields will be auto-fetched from the profile if not provided. The API will verify that a pending invitation exists before attempting withdrawal.
Check relationship status with specific account
Check the relationship between a specific LinkedIn account and a target profile. Useful for multi-account setups to check relationships from different accounts. Returns connection degree, follow status, and connection status.