Skip to content
RallyHere Docs

Get Friend Relationship V2

GET
/friends/v2/player/{player_uuid}/friend/{other_player_uuid}

Get the relationship status with the other Player.

Note: This API supports etags and will return the etag header when with the response. Clients and then utilize the if-none-match header to avoid having to reload the response if it has not changed or to use it to modify the relationship without loosing updates.

Permissions Required: friend:friend_list:read

Authorizations

Parameters

Path Parameters

player_uuid
required
string format: uuid
other_player_uuid
required
string format: uuid

Header Parameters

if-none-match

If you provide the ETag that matches the current ETag for this resource, a 304 response will be return - indicating that the resource has not changed.

string

If you provide the ETag that matches the current ETag for this resource, a 304 response will be return - indicating that the resource has not changed.

Responses

200

Successful Response

Represents the relationship with a potential friend.

object
friends_player_uuid
required
string format: uuid
status
required
string
Allowed values: NONE FRIENDS FRIEND_REQUEST_SENT FRIEND_REQUEST_PENDING FRIEND_REQUEST_DECLINED_BY_OTHER
notes
string
last_modified_on
required
string format: date-time

Headers

ETag
string

Used to identify this version of the content. Provide with a get request to avoid downloading the same data multiple times.

304

Content still has the same etag and has not changed

400

Bad Request

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

403

Forbidden

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

409

Conflict

object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string