> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Invitation Status

> Check the status of connection and invitation with a LinkedIn profile

Retrieve the connection degree and invitation status between your account and any LinkedIn profile. This endpoint provides information about whether you are connected, have a pending invitation, or have no relationship with the target profile.

<Note>
  **Credit Usage:** 1 credit per request
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Body Parameters

<ParamField body="linkedin_url" type="string" required>
  URL of the LinkedIn profile you want to check (e.g., [https://www.linkedin.com/in/username/](https://www.linkedin.com/in/username/))
</ParamField>

<ParamField body="country" type="string" default="FR">
  Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
</ParamField>

<ParamField body="login_token" type="string" required>
  LinkedIn authentication cookie obtained from the login/verify process
</ParamField>

### Response

<ResponseField name="status" type="string">
  Request status (success/error)
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="invitation_state" type="string">
      Current state of invitation (ACCEPTED, PENDING, NO\_INVITATION)
    </ResponseField>

    <ResponseField name="invitation_type" type="string">
      Type of invitation (CONNECTED, SENT, RECEIVED, null)
    </ResponseField>

    <ResponseField name="invitation_id" type="string">
      Unique identifier of the invitation (if exists)
    </ResponseField>

    <ResponseField name="member_distance" type="integer">
      Degree of connection (1, 2, 3, or null)
    </ResponseField>

    <ResponseField name="message" type="string">
      Human-readable summary of the relationship status
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Connected (1st degree) theme={null}
  {
   "status": "success",
   "data": {
     "invitation_state": "ACCEPTED",
     "invitation_type": "CONNECTED",
     "invitation_id": null,
     "member_distance": 1,
     "message": "You are connected with this person"
   }
  }
  ```

  ```json Pending Invitation (2nd degree) theme={null}
  {
   "status": "success",
   "data": {
     "invitation_state": "PENDING",
     "invitation_type": "SENT",
     "invitation_id": "7310081824666365952",
     "member_distance": 2,
     "message": "Invitation pending"
   }
  }
  ```

  ```json No Invitation (3rd degree) theme={null}
  {
   "status": "success",
   "data": {
     "invitation_state": "NO_INVITATION",
     "invitation_type": null,
     "invitation_id": null,
     "member_distance": 3,
     "message": "No invitation found"
   }
  }
  ```
</ResponseExample>