> ## 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 Received Invitations

> Retrieve your LinkedIn invitations with pagination support

Get a list of your LinkedIn invitations (received) with detailed information about each invitation.

<Note>
  Credit cost varies based on usage mode:

  * Pagination mode: **1 credit per page**
  * Total results mode: **1 credit per 10 invitations** (rounded up)
</Note>

### Header Parameters

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

### Body Parameters

<ParamField body="login_token" type="string" required>
  LinkedIn authentication cookie obtained from the login/verify process
</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="start_page" type="integer">
  Starting page number for pagination mode
</ParamField>

<ParamField body="end_page" type="integer">
  Ending page number for pagination mode
</ParamField>

<ParamField body="total_results" type="integer" default="10">
  Number of invitations to retrieve (used when not in pagination mode)
</ParamField>

<ParamField body="invitation_type" type="string">
  Type of invitations to retrieve (optional)
</ParamField>

### Response

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

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="total_results" type="integer">
      Number of invitations returned in this response
    </ResponseField>

    <ResponseField name="total_available_results" type="integer">
      Total number of invitations available
    </ResponseField>

    <ResponseField name="invitations" type="array">
      <Expandable title="Invitation Object">
        <ResponseField name="name" type="string">
          Full name of the person
        </ResponseField>

        <ResponseField name="profile_url" type="string">
          LinkedIn profile URL
        </ResponseField>

        <ResponseField name="subtitle" type="string">
          Professional headline or description
        </ResponseField>

        <ResponseField name="sent_time" type="string">
          Time elapsed since the invitation was sent
        </ResponseField>

        <ResponseField name="sent_time_days" type="integer">
          Number of days since the invitation was sent (precise to within 7 days for invitations older than a week)
        </ResponseField>

        <ResponseField name="message" type="string">
          Invitation message (if any)
        </ResponseField>

        <ResponseField name="invitation_id" type="integer">
          Unique identifier for the invitation
        </ResponseField>

        <ResponseField name="shared_secret" type="string">
          Shared secret for the invitation
        </ResponseField>

        <ResponseField name="shared_connections" type="string">
          Number of mutual connections
        </ResponseField>

        <ResponseField name="invitation_state" type="string">
          Current state of the invitation (e.g., "PENDING")
        </ResponseField>

        <ResponseField name="entity_urn" type="string">
          LinkedIn entity URN for the invitation
        </ResponseField>

        <ResponseField name="profile_picture" type="string">
          URL of the person's profile picture
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pagination" type="object">
      <Expandable title="Pagination Object">
        <ResponseField name="start_page" type="integer">
          Starting page number of the request
        </ResponseField>

        <ResponseField name="end_page" type="integer">
          Ending page number of the request
        </ResponseField>

        <ResponseField name="results_per_page" type="integer">
          Number of results per page
        </ResponseField>

        <ResponseField name="pages_fetched" type="integer">
          Number of pages successfully fetched
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": "success",
    "data": {
      "total_results": 20,
      "total_available_results": 36,
      "invitations": [
        {
          "name": "Sandrine BRUNET",
          "profile_url": "https://www.linkedin.com/in/sandrine-brunet-6a910b94",
          "subtitle": "Cost and Time killer, J'accompagne les entreprises à faire des économies et gagner en temps et sérénité",
          "sent_time": "1 week ago",
          "sent_time_days": 7,
          "message": null,
          "invitation_id": 7331558767219683329,
          "shared_secret": "9gAd0GPh",
          "shared_connections": "13 mutual connections",
          "invitation_state": "PENDING",
          "entity_urn": "urn:li:fsd_invitation:7331558767219683329",
          "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1673297968581?e=1753920000&v=beta&t=vlKK6RCRuU4H3Yp8OUgov5OigmYLxlaeqPUiOVuK0yo"
        }
      ],
      "pagination": {
        "start_page": 1,
        "end_page": 2,
        "results_per_page": 10,
        "pages_fetched": 2
      }
    }
  }
  ```

  ```json Error Response - Invalid Cookie theme={null}
  {
    "status": "error",
    "message": "Invalid or expired LinkedIn cookie"
  }
  ```

  ```json Error Response - Insufficient Credits theme={null}
  {
    "status": "error",
    "message": "Insufficient credits available"
  }
  ```
</ResponseExample>

### Notes

* The endpoint supports two modes of operation:
  1. Pagination mode: Specify both `start_page` and `end_page` to fetch specific pages
  2. Total results mode: Use `total_results` to specify the number of invitations to fetch
* When using pagination, `end_page` must be greater than or equal to `start_page`
* The `message` field may be null if no message was included with the invitation
* The `sent_time` is returned in a human-readable format (e.g., "1 week ago", "2 months ago")
* Profile pictures URLs are temporary and will expire