---
title: "LinkedIn proxy: get invitation/connection status with a member"
method: GET
path: "/api/linkedin/{account_id}/invitation-status"
tags: ["LinkedIn – Connections"]
---

# LinkedIn proxy: get invitation/connection status with a member

`GET /api/linkedin/{account_id}/invitation-status`

## Request

- Base URL: `https://api.reachmcp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reachmcp.com/api/linkedin/{account_id}/invitation-status`
- Auth: API key in header `X-API-Key`

Returns the connection and invitation status between the connected account and a LinkedIn member.

**Input** (``linkedin_id_or_url``):

- Internal member ID: ``ACoAABcDEFg...``
- Vanity name: ``john-doe``
- Full profile URL: ``https://www.linkedin.com/in/john-doe``

**``invitation_type``** values:

- ``SENT`` — invitation sent, awaiting acceptance
- ``PENDING`` — invitation received, not yet accepted
- ``WITHDRAWN`` — invitation was withdrawn
- ``REFUSED`` — invitation was declined

## Path parameters

- `account_id` integer, required

## Query parameters

- `linkedin_id_or_url` string, required: LinkedIn member ID, vanity name, or profile URL.

## Response `200`

Successful Response

- LinkedInInvitationStatusOut: Connection / invitation status between the connected account and a LinkedIn member.
  - `is_connection` boolean, required: True if the member is a 1st-degree connection.
  - `degree` integer, nullable: Connection distance (1, 2 or 3).
  - `invitation_type` string, nullable: 'SENT' (pending sent), 'PENDING' (received, awaiting acceptance), 'WITHDRAWN', or 'REFUSED'.
  - `invitation_id` string, nullable: Invitation URN, if any.
  - `invitation_secret` string, nullable: Shared secret, required to accept a received invitation.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reachmcp/apis/mcp-reach.md) · [All operations](https://skmtc.dev/reachmcp/apis/mcp-reach/llms.txt) · [OpenAPI document](https://skmtc.dev/reachmcp/apis/mcp-reach/revisions/1a85fdaf3f7c?raw)