Platform API

<back to all web services

GetRelatedItems

Get related items related to the specified object.

Requires Authentication
The following routes are available for this service:
All Verbs/api/relateditems/{ObjectId}
GetRelatedItems Parameters:
NameParameterData TypeRequiredDescription
ObjectIdpathGuidYesObject to get related items for.
RelatedItemsLevelqueryGuidYesSignificant Only or All
IsPagedModequeryboolNoReturn all connections or paged results?
PagedModel Parameters:
NameParameterData TypeRequiredDescription
PageNumberformintNoPage Number to retrieve
PageSizeformintNoNumber of records to retrieve
SortIndexformintNoIndex of field to sort results by
SortOrderformintNoSort Order - Ascending or Descending
SortOrder Enum:
Ascending
Descending
GetRelatedItemsResponse Parameters:
NameParameterData TypeRequiredDescription
RelatedItemsformList<RelatedItemsModel>No
TotalRelatedItemsformintNo
ResponseStatusformResponseStatusNo
RelatedItemsModel Parameters:
NameParameterData TypeRequiredDescription
ObjectIdformGuidYesObject linked to the related item.
RelatedItemNameformstringNoRelated item name.
RelatedItemTypeformstringNoRelated item type.
CreatedAtformDateTimeYesDate of creation of the related item.
CreatedByNameformstringNoContact who created the related item
CreatedByIdformGuidNoContact who created the related item
CreatedByThumbnailUrlformstringNoProfile photo of the contact who created the related item
RelationshipformstringNoRelationship between objects linked to the related item
IsSignificantformboolYesIs the related item significant?

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/relateditems/{ObjectId} HTTP/1.1 
Host: pfapi.pstpf.com.au 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	IsPagedMode: False,
	PageNumber: 0,
	PageSize: 0,
	SortIndex: 0,
	SortOrder: Ascending
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	RelatedItems: 
	[
		{
			RelatedItemName: String,
			RelatedItemType: String,
			CreatedAt: 0001-01-01,
			CreatedByName: String,
			CreatedByThumbnailUrl: String,
			Relationship: String,
			IsSignificant: False
		}
	],
	TotalRelatedItems: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	}
}