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

# Collaborator Request Status

> Check whether invited collaborators accepted, declined or are pending on Instagram Reels, images and carousels, or on Facebook Reels.

When you [invite an Instagram collaborator to a post](https://www.ayrshare.com/docs/apis/post/social-networks/instagram.md#collaboration)
or a [Facebook Page collaborator to a Facebook Reel](https://www.ayrshare.com/docs/apis/post/social-networks/facebook.md#facebook-reels),
you can check the request status using this endpoint.

Use this endpoint for:

<ul>
  <li>Instagram collaborator invitations on Reels, images, and carousels.</li>
  <li>Facebook collaborator invitations on Facebook Reels.</li>
</ul>

## Header Parameters

**Authorization** `string` *required*

[API Key](https://www.ayrshare.com/docs/apis/overview.md#authorization) of the Primary Profile.

Format: `Authorization: Bearer API_KEY`
**Profile-Key** `string`

[Profile Key](https://www.ayrshare.com/docs/apis/overview.md#profile-key-format) of a User Profile.

Format: `Profile-Key: PROFILE_KEY`

## Path Parameters

**id** `string` *required*

In the path parameter, use an [ID Type](https://www.ayrshare.com/docs/apis/overview.md#id-types)

## Query Parameters

**searchPlatformId** `boolean` *required*

Set to `true`. Required if using a Social Post ID.

**platform** `string`

Set to `facebook` when the `id` is a Facebook Social Post ID. Required in that case — without
it, the request looks up the ID on Instagram instead. Also use it to force Facebook collaborator
lookup for an Ayrshare post that has multiple platform IDs.

```json 200 theme={"system"}
{
  "collaborators": [
    {
      "id": "17841401319910272",
      "username": "ayrshare",
      "inviteStatus": "accepted"
    },
    {
      "id": "17841401319910273",
      "username": "ayrshare1",
      "inviteStatus": "declined"
    },
    {
      "id": "17841401319910274",
      "username": "ayrshare2",
      "inviteStatus": "pending"
    }
  ],
  "lastUpdated": "2024-03-08T04:08:18.979Z",
  "nextUpdate": "2024-03-08T04:09:18.979Z"
}
```

```json 200 Facebook Reels theme={"system"}
{
  "collaborators": [
    {
      "id": "123456789012345",
      "username": "collaboratorpage",
      "inviteStatus": "pending"
    }
  ],
  "lastUpdated": "2026-08-24T04:08:18.979Z",
  "nextUpdate": "2026-08-24T04:09:18.979Z"
}
```

```json 400 theme={"system"}
{
  "action": "analytics",
  "status": "error",
  "code": 294,
  "message": "Error getting analytics."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.