Entities - Get where-used

API Url

Return a list of references where this entity record is used.

GET
http://localhost:16010/ProMarkREST/web/Entity/where-used/{type}/{id}

Permissions: user

Request headers

FieldTypeDescription
Accept-LanguageoptionalString

=en-GB Language use for localization.

X-ClientoptionalString

=Client type.

Allowed values:"Portal""Mobile""Admin"
X-RoleoptionalNumber

ProMark role (1: Employee, 2: User).

Allowed values:{12}
X-WebPart-IdoptionalNumber

Unique web-part identifier.

Path parameters

FieldTypeDescription
idString

ID of the entity.

typeString

Name of the entity.

Success 200

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data.

    whereUsedObject[]

Object containing a list of where-used entries.

      descriptionString

The description of the entity where it is used.

      entityNameString

Entity name. Used for grouping

      entityTypeString

Path of the entity.

      idString

The id of the entity where it is used.

      internalIdString

InternalId. For links

      typeString

Description of the where used type.

  messageoptionalObject

Object containing response messages.

    codeNumber

Message code.

    textString

Message text.

    typeString

Type of message.

Allowed values:"warning""info"

Success example:

HTTP/1.1 200 OK
{
"response": {
"data": {
"whereUsed": [
{
"type": "Department in time queue for employee",
"id": "SCP",
"description": "Sheldon Cooper"
"entityType": "employees",
"internalId": "624",
"entityName": "Employees"
}
]
}
}
}

Error 4xx

FieldTypeDescription
responseObject

Main object containing the response data.

  dataObject

Object containing the requested data (empty).

  errorCodeNumber

Error code.

  errorMessageString

Error description.