API Reference

This API provides a variety of interfaces for working with the Custom Sets feature.

You should have the API Key while retrieving or updating your data. Without these API keys, you cannot access your APIs.

Custom set object

Top level

{
  "id": "cd438fcb-3525-484c-ba83-858377d91948",
  "name": "Countries",
  "items_count": 3,
  "data": {},
  "teams_count": 1,
  "teams": [{}],
  "created_at": "2024-03-26T17:24:19.2014490Z",
  "created_by": {},
  "updated_at": "2024-03-26T17:26:58.6180210Z",
  "updated_by": {}
}
KeyTypeDescription
idStringA unique identifier for the custom set.
nameStringThe name of the custom set.
items_countNumberCount of custom set items associated with the custom set
dataObjectCustom set data Object (It contains the custom set items)
teams_countNumberCount of teams which has access to this custom set
teamsArrayAn array of team object(s) containing general information about the team that has access to this custom set.
created_atStringThe date and time the template was created in ISO 8601 date and time format.
created_byObjectGeneral information about the user who created the template.
updated_atStringThe date and time the template was last updated in ISO 8601 date and time format.
updated_byObjectGeneral information about the user who last updated the template.

Custom set data object

{
  "items_count": 3,
  "items": [{}]
}
KeyTypeDescription
items_countNumberCount of custom set items associated with the custom set
itemsArrayAn array of custom set item's object(s), which contains details of custom set items associated with that particular custom set

Item object (custom set item)

{
  "id": "0f0681c3-0090-49bc-afef-ef914032abd7",
  "item_name": "China",
  "score": -1,
  "color": "#e01e53",
  "is_flagged": true
}
KeyDescription
idA unique identifier for the custom set item.
item_nameValue of the custom set item (which will be displayed in UI)
scoreThe score for the custom set item (when a custom set item is selected while performing an inspection, if the item has a score then that question will be scored using this value).
colorThe color for the custom set item (this is used for visual representation while performing an inspection, if the item has a color set then when the user selects that item it will be displayed on UI).
is_flaggedTo determine if the custom set item is flagged or not.

Note: To know more about what scoring, flagging, and color coding feature is visit this link - scoring-flagging-and-color-coding.