GET api/v1.0/Friends/GetPendingReceivedFriendRequests

Returns a List of FriendModel objects representing the pending Friend Requests that the Current User has RECEIVED.

Request Information

URI Parameters

None.

Body Parameters

None.

Response Information

Resource Description

Collection of Friend
NameDescriptionTypeAdditional information
FirstName

If the Current Contact is the SENDER of the Friend Request, the RECIPIENT's first name. If the Current Contact is the RECIPIENT of the Friend Request, the SENDER's first name.

string

Required

LastName

If the Current Contact is the SENDER of the Friend Request, the RECIPIENT's last name. If the Current Contact is the RECIPIENT of the Friend Request, the SENDER's last name.

string

Required

DisplayName

If the Current Contact is the SENDER of the Friend Request, the RECIPIENT's display name. If the Current Contact is the RECIPIENT of the Friend Request, the SENDER's display name.

string

Required

LinkToProfile

If the Current Contact is the SENDER of the Friend Request, the link to the RECIPIENT's profile page. If the Current Contact is the RECIPIENT of the Friend Request, the link to the SENDER's profile page.

string

None.

LinkToSmallImage

If the Current Contact is the SENDER of the Friend Request, the link to the RECIPIENT's small image. If the Current Contact is the RECIPIENT of the Friend Request, the link to the SENDER's small image.

string

None.

LinkToLargeImage

If the Current Contact is the SENDER of the Friend Request, the link to the RECIPIENT's large image. If the Current Contact is the RECIPIENT of the Friend Request, the link to the SENDER's large image.

string

None.

IsCompany

If the Current Contact is the SENDER of the Friend Request, if the RECIPIENT is a company. If the Current Contact is the RECIPIENT of the Friend Request, if the SENDER is a company.

boolean

None.

FriendRequestRecordKey

Unique Identifier for the friend request.

globally unique identifier

None.

IsActive

If the friend request is active.

boolean

None.

RequestorContactKey

This field is deprecated, please use RequestedByContactKey instead.

globally unique identifier

None.

RequestedByContactKey

Contact key of the user who initiated the friend request.

globally unique identifier

None.

RequesteeContactKey

Contact key of the user who received the friend request.

globally unique identifier

None.

InvitedOn

DateTime of when friend invite was sent.

date

None.

AcceptedOn

DateTime of when friend invite was accepted. Null if not yet accepted

date

None.

RequestedDate

DateTime of when friend invite was created. Typically synonymous with InvitedOn.

date

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "FirstName": "sample string 1",
    "LastName": "sample string 2",
    "DisplayName": "sample string 3",
    "LinkToProfile": "sample string 4",
    "LinkToSmallImage": "sample string 5",
    "LinkToLargeImage": "sample string 6",
    "IsCompany": true,
    "FriendRequestRecordKey": "af674c16-881d-4ffb-b7cd-781189008b63",
    "IsActive": true,
    "RequestorContactKey": "a8f7ae58-e761-4378-9a35-c6dccb9a9497",
    "RequestedByContactKey": "69dfebda-4ec9-48fb-9216-b50fc3e2b058",
    "RequesteeContactKey": "743ccdb5-b445-4c1a-b73a-120c27a17c0f",
    "InvitedOn": "2024-12-26T04:05:20.1870465Z",
    "AcceptedOn": "2024-12-26T04:05:20.1870465Z",
    "RequestedDate": "2024-12-26T04:05:20.1870465Z"
  },
  {
    "FirstName": "sample string 1",
    "LastName": "sample string 2",
    "DisplayName": "sample string 3",
    "LinkToProfile": "sample string 4",
    "LinkToSmallImage": "sample string 5",
    "LinkToLargeImage": "sample string 6",
    "IsCompany": true,
    "FriendRequestRecordKey": "af674c16-881d-4ffb-b7cd-781189008b63",
    "IsActive": true,
    "RequestorContactKey": "a8f7ae58-e761-4378-9a35-c6dccb9a9497",
    "RequestedByContactKey": "69dfebda-4ec9-48fb-9216-b50fc3e2b058",
    "RequesteeContactKey": "743ccdb5-b445-4c1a-b73a-120c27a17c0f",
    "InvitedOn": "2024-12-26T04:05:20.1870465Z",
    "AcceptedOn": "2024-12-26T04:05:20.1870465Z",
    "RequestedDate": "2024-12-26T04:05:20.1870465Z"
  }
]

application/xml, text/xml

Sample:
<ArrayOfFriend xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
  <Friend>
    <AcceptedOn>2024-12-25T23:05:20.1870465-05:00</AcceptedOn>
    <DisplayName>sample string 3</DisplayName>
    <FirstName>sample string 1</FirstName>
    <FriendRequestRecordKey>af674c16-881d-4ffb-b7cd-781189008b63</FriendRequestRecordKey>
    <InvitedOn>2024-12-25T23:05:20.1870465-05:00</InvitedOn>
    <IsActive>true</IsActive>
    <IsCompany>true</IsCompany>
    <LastName>sample string 2</LastName>
    <LinkToLargeImage>sample string 6</LinkToLargeImage>
    <LinkToProfile>sample string 4</LinkToProfile>
    <LinkToSmallImage>sample string 5</LinkToSmallImage>
    <RequestedByContactKey>69dfebda-4ec9-48fb-9216-b50fc3e2b058</RequestedByContactKey>
    <RequestedDate>2024-12-25T23:05:20.1870465-05:00</RequestedDate>
    <RequesteeContactKey>743ccdb5-b445-4c1a-b73a-120c27a17c0f</RequesteeContactKey>
    <RequestorContactKey>a8f7ae58-e761-4378-9a35-c6dccb9a9497</RequestorContactKey>
  </Friend>
  <Friend>
    <AcceptedOn>2024-12-25T23:05:20.1870465-05:00</AcceptedOn>
    <DisplayName>sample string 3</DisplayName>
    <FirstName>sample string 1</FirstName>
    <FriendRequestRecordKey>af674c16-881d-4ffb-b7cd-781189008b63</FriendRequestRecordKey>
    <InvitedOn>2024-12-25T23:05:20.1870465-05:00</InvitedOn>
    <IsActive>true</IsActive>
    <IsCompany>true</IsCompany>
    <LastName>sample string 2</LastName>
    <LinkToLargeImage>sample string 6</LinkToLargeImage>
    <LinkToProfile>sample string 4</LinkToProfile>
    <LinkToSmallImage>sample string 5</LinkToSmallImage>
    <RequestedByContactKey>69dfebda-4ec9-48fb-9216-b50fc3e2b058</RequestedByContactKey>
    <RequestedDate>2024-12-25T23:05:20.1870465-05:00</RequestedDate>
    <RequesteeContactKey>743ccdb5-b445-4c1a-b73a-120c27a17c0f</RequesteeContactKey>
    <RequestorContactKey>a8f7ae58-e761-4378-9a35-c6dccb9a9497</RequestorContactKey>
  </Friend>
</ArrayOfFriend>