Newmetrix public API

Authentication

Authentication API

Authentication API will perform basic authentication into Newmetrix and return API token that will be used for subsequent API calls. The value of 'token' in the response will have to be supplied in 'X-Auth-Token' HTTP header with every API. Token needs to be refreshed once expired.

'expires' will specify token expiration time measured in milliseconds from midnight, January 1, 1970 UTC.

request

POST /api/v1/authenticate HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 59

{
  "username" : "vgorsky@smartvid.io",
  "password" : ""
}

Table 1. request body
Path	Type	Description
`username`	`String`	User name
`password`	`String`	Password

Table 2. response fields description
Path	Type	Description
`token`	`String`	Token to be used in 'X-Auth-Token' HTTP header
`expires`	`Number`	Expiration time

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 113

{
  "token" : "vgorsky@smartvid.io:1712750937555:e55e74664b341692ebe2b5b9c1d230b7",
  "expires" : 1712750937555
}

Observations

Observations retrieve API

Observations retrieve API can be used to retrieve observations with their related data, such as trade partners, assignees, etc, from the system for a set of project(s). Observations retrieve API supports incremental date-based retrieval and pagination.

If custom configuration is enabled for the organization, custom field values will be returned as part of each observation.

request

GET /api/v1/organization/3703ced6-687c-4b3d-8568-afa5cb94808c/observation?projectId=4a2cbd73-a060-493f-b1b6-bba421823171&projectId=d9a2c5e3-7d02-4e15-905d-78477e31e867&updatedAt=2018-01-01T00%3A00%3A00.000%2B02%3A00&useExternalId=false&page=0&perPage=1000 HTTP/1.1
Host: api-public.smartvid.io

Table 3. /api/v1/organization/{organizationId}/observation
Parameter	Description
`organizationId`	Internal ID of the organization

Table 4. request parameters
Parameter	Description
`projectId`	Set of project id(s) to get observation data for
`useExternalId`	When set to true, projectId is the ID of the project in the external system
`page`	Page
`perPage`	Number of observations per page. This value cannot be greater than 1,000
`updatedAt`	Return observation(s) created or updated after a specific date. Date format is in ISO 8601

Table 5. response fields description
Path	Type	Description
`observations[].observation.status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`observations[].observation.type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`observations[].observation.observationId`	`String`	Internal ID of the observation
`observations[].observation.projectId`	`String`	Internal ID of the project
`observations[].observation.identificationMethod`	`String`	Method of identification
`observations[].observation.notes`	`String`	Observation notes
`observations[].observation.actionTaken`	`String`	Action taken
`observations[].observation.recommendedAction`	`String`	Recommended action
`observations[].observation.reviewComment`	`String`	Review comment
`observations[].observation.userFriendlyId`	`String`	User-friendly observation ID in format - SO-id
`observations[].observation.externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`observations[].observation.externalObservationId`	`String`	External ID provided for observation, used for observation lookup
`observations[].observation.severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`observations[].observation.frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`observations[].observation.risk`	`Number`	Calculated risk of the observation
`observations[].observation.createdDate`	`String`	Creation date of the observation. Date format is in ISO 8601
`observations[].observation.updatedDate`	`String`	Update date of the observation. Date format is in ISO 8601
`observations[].observation.isGreatCatch`	`Boolean`	Is this observation a great catch
`observations[].observation.hazardCategory`	`String`	Hazard category
`observations[].observation.dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`observations[].observation.closedDate`	`String`	The date the observation was closed. Date format is in ISO 8601
`observations[].observation.reviewedDate`	`String`	The date the observation was last reviewed. Date format is in ISO 8601
`observations[].tradePartner.id`	`String`	Internal ID of the trade partner
`observations[].tradePartner.externalTradePartnerId`	`String`	External ID of the trade partner
`observations[].tradePartner.organizationId`	`String`	Internal ID of the organization this trade partner belongs to
`observations[].tradePartner.name`	`String`	Name of the trade partner
`observations[].tradePartner.email`	`String`	Email of the trade partner
`observations[].tradePartner.trade`	`String`	Trade
`observations[].tradePartner.isActive`	`Boolean`	The indicator if the given trade partner is active or not
`observations[].assignee.id`	`String`	Internal ID of the assignee user
`observations[].assignee.firstName`	`String`	First name of the assignee user
`observations[].assignee.lastName`	`String`	Last name of the assignee user
`observations[].assignee.email`	`String`	Email of the assignee user
`observations[].assignee.externalUserId`	`String`	An external assignee user ID
`observations[].assignee.isActive`	`Boolean`	The indicator if the given user is active
`observations[].assignee.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].assignee.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].createdByUser.id`	`String`	Internal ID of the observation creator user
`observations[].createdByUser.firstName`	`String`	First name of the observation creator user
`observations[].createdByUser.lastName`	`String`	Last name of the observation creator user
`observations[].createdByUser.email`	`String`	Email of the observation creator user
`observations[].createdByUser.externalUserId`	`String`	An external observation creator user ID
`observations[].createdByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].createdByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].createdByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].updatedByUser.id`	`String`	Internal ID of the user who last updated the observation
`observations[].updatedByUser.firstName`	`String`	First name of user who last updated the observation
`observations[].updatedByUser.lastName`	`String`	Last name of user who last updated the observation
`observations[].updatedByUser.email`	`String`	Email of the user who last updated the observation
`observations[].updatedByUser.externalUserId`	`String`	An external ID of the user who last updated the observation
`observations[].updatedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].updatedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].updatedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].closedByUser.id`	`String`	Internal ID of the user who closed the observation
`observations[].closedByUser.firstName`	`String`	First name of user who closed the observation
`observations[].closedByUser.lastName`	`String`	Last name of user who closed the observation
`observations[].closedByUser.email`	`String`	Email of the user who closed the observation
`observations[].closedByUser.externalUserId`	`String`	An external ID of the user who closed the observation
`observations[].closedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].closedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].closedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].reviewedByUser.id`	`String`	Internal ID of the user who last reviewed the observation
`observations[].reviewedByUser.firstName`	`String`	First name of user who last reviewed the observation
`observations[].reviewedByUser.lastName`	`String`	Last name of user who last reviewed the observation
`observations[].reviewedByUser.email`	`String`	Email of the user who last reviewed the observation
`observations[].reviewedByUser.externalUserId`	`String`	An external ID of the user who last reviewed the observation
`observations[].reviewedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].reviewedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].reviewedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].project.id`	`String`	The internal ID of the project
`observations[].project.externalProjectId`	`String`	The ID of the project in the external system
`observations[].project.projectNumber`	`String`	The human readable project identifier
`observations[].project.projectGroupId`	`String`	The internal ID of the project group for this project
`observations[].project.inactive`	`Boolean`	Whether project is inactive or active
`observations[].project.organizationId`	`String`	The internal ID of the organization this project belongs to
`observations[].project.name`	`String`	The name of the project
`observations[].project.description`	`String`	The description of the project
`observations[].project.location`	`String`	The location of the project
`observations[].projectGroup.id`	`String`	Internal ID of the project group (region/business unit)
`observations[].projectGroup.organizationId`	`String`	Internal ID of the organization this project group belongs to
`observations[].projectGroup.name`	`String`	Name of the project group
`observations[].projectGroup.description`	`String`	Description of the project group
`observations[].organization.id`	`String`	Internal ID of the organization
`observations[].organization.name`	`String`	Name of the organization
`observations[].organization.description`	`String`	Description of the organization
`observations[].observation.customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`observations[].observation.customFields[].id`	`String`	Id of the custom field value
`observations[].observation.customFields[].identifier`	`String`	Identifier of the custom field value
`observations[].observation.customFields[].dataType`	`String`	Data type of the custom field value
`observations[].observation.customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`observations[].observation.customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`observations[].observation.customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`observations[].observation.customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`observations[].observation.customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 8978

{
  "observations" : [ {
    "observation" : {
      "observationId" : "2f65c421-a169-4b2d-8ec6-240ad02fe26b",
      "projectId" : "4a2cbd73-a060-493f-b1b6-bba421823171",
      "status" : "NEW",
      "hazardCategory" : "Sample hazard category",
      "identificationMethod" : "Sample identification method",
      "notes" : "Sample observation note",
      "severity" : "CRITICAL",
      "frequency" : "DAILY",
      "risk" : 25.0,
      "recommendedAction" : "Sample recommended action",
      "reviewComment" : "Test review comment",
      "dueDate" : "2024-04-10T10:08:58.316+0000",
      "createdDate" : "2024-04-10T10:08:58.406+0000",
      "updatedDate" : "2024-04-10T10:08:58.406+0000",
      "closedDate" : "2024-04-10T10:08:58.316+0000",
      "reviewedDate" : "2024-04-10T10:08:58.316+0000",
      "type" : "NEGATIVE",
      "isGreatCatch" : true,
      "actionTaken" : "Test action taken",
      "externalId" : 1,
      "userFriendlyId" : "SO-1",
      "externalObservationId" : "ABC123",
      "customFields" : [ {
        "id" : "e06d05d3-ea42-4d26-aef9-62d3fc04bd98",
        "identifier" : "booleanField",
        "dataType" : "BOOLEAN",
        "valueBoolean" : true
      }, {
        "id" : "cdf1b4bf-6d16-448c-a629-c11d66b16ffd",
        "identifier" : "dateField",
        "dataType" : "DATE"
      }, {
        "id" : "4d063744-a9e2-47bf-a4b1-9e5832df34e3",
        "identifier" : "realField",
        "dataType" : "REAL",
        "valueReal" : 1.9900000095367432
      }, {
        "id" : "e191a5ab-0677-4ebd-addd-820a995b1c5a",
        "identifier" : "longField",
        "dataType" : "LONG",
        "valueLong" : 999999
      } ]
    },
    "tradePartner" : {
      "id" : "0d86745d-8efe-4031-9757-b37cc1216fe8",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "externalTradePartnerId" : "External ID",
      "name" : "Sample Trade Partner",
      "trade" : "Painting",
      "isActive" : true,
      "email" : "4d312c4e-ed1a-4f39-9de7-a5eaa0aeabda_tp1@examples.com"
    },
    "assignee" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "createdByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "updatedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "closedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "reviewedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "project" : {
      "id" : "4a2cbd73-a060-493f-b1b6-bba421823171",
      "externalProjectId" : "6d9c93cd-bc9d-48de-b3c7-7dd364c4b2d3",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Project with observations",
      "location" : "Sample location",
      "projectGroupId" : "e8af20eb-b233-41b3-b17a-12a9b8f66f55",
      "inactive" : false
    },
    "projectGroup" : {
      "id" : "e8af20eb-b233-41b3-b17a-12a9b8f66f55",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Northeast",
      "description" : "Northeast division"
    },
    "organization" : {
      "id" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Sample General Contractor Organization",
      "description" : "Sample description"
    }
  }, {
    "observation" : {
      "observationId" : "f7627163-7bf0-4a16-a455-a247d5403432",
      "projectId" : "4a2cbd73-a060-493f-b1b6-bba421823171",
      "status" : "CLOSED",
      "hazardCategory" : "Sample hazard category #2",
      "identificationMethod" : "Sample identification method #2",
      "notes" : "Sample observation note #2",
      "severity" : "CRITICAL",
      "frequency" : "ANNUALLY",
      "risk" : 25.0,
      "recommendedAction" : "Sample recommended action",
      "reviewComment" : "Test review comment",
      "dueDate" : "2024-04-10T10:08:59.054+0000",
      "createdDate" : "2024-04-10T10:08:59.090+0000",
      "updatedDate" : "2024-04-10T10:08:59.090+0000",
      "closedDate" : "2024-04-10T10:08:59.055+0000",
      "reviewedDate" : "2024-04-10T10:08:59.055+0000",
      "type" : "NEGATIVE",
      "isGreatCatch" : true,
      "actionTaken" : "Test action taken",
      "externalId" : 2,
      "userFriendlyId" : "SO-2",
      "externalObservationId" : "XYZ456",
      "customFields" : [ {
        "id" : "e966ce37-1951-4e60-b031-57806f32224a",
        "identifier" : "booleanField",
        "dataType" : "BOOLEAN",
        "valueBoolean" : true
      }, {
        "id" : "c86b9f46-1f7a-4cbc-94c4-3a4dc6665711",
        "identifier" : "dateField",
        "dataType" : "DATE"
      }, {
        "id" : "5d0b6412-51dc-426e-9a10-a9a8a5a06bb5",
        "identifier" : "realField",
        "dataType" : "REAL",
        "valueReal" : 1.9900000095367432
      }, {
        "id" : "e01559f9-c3e6-4339-a94f-5eff3cc67935",
        "identifier" : "longField",
        "dataType" : "LONG",
        "valueLong" : 999999
      } ]
    },
    "tradePartner" : {
      "id" : "0d86745d-8efe-4031-9757-b37cc1216fe8",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "externalTradePartnerId" : "External ID",
      "name" : "Sample Trade Partner",
      "trade" : "Painting",
      "isActive" : true,
      "email" : "4d312c4e-ed1a-4f39-9de7-a5eaa0aeabda_tp1@examples.com"
    },
    "assignee" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "createdByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "updatedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "closedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "reviewedByUser" : {
      "id" : "4c2a85be-15ef-4b20-8bd7-a033fedb265e",
      "firstName" : "First Name",
      "lastName" : "Last Name",
      "email" : "806dc418-2228-44f3-8ea3-20511b7eee11_test@examples.com",
      "externalUserId" : "EXT_UID_1",
      "isActive" : false,
      "isInvited" : false,
      "isSso" : false
    },
    "project" : {
      "id" : "4a2cbd73-a060-493f-b1b6-bba421823171",
      "externalProjectId" : "6d9c93cd-bc9d-48de-b3c7-7dd364c4b2d3",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Project with observations",
      "location" : "Sample location",
      "projectGroupId" : "e8af20eb-b233-41b3-b17a-12a9b8f66f55",
      "inactive" : false
    },
    "projectGroup" : {
      "id" : "e8af20eb-b233-41b3-b17a-12a9b8f66f55",
      "organizationId" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Northeast",
      "description" : "Northeast division"
    },
    "organization" : {
      "id" : "3703ced6-687c-4b3d-8568-afa5cb94808c",
      "name" : "Sample General Contractor Organization",
      "description" : "Sample description"
    }
  } ]
}

Get Observation API

Get Observation API can be used to retrieve an observation with it’s related data, such as trade partners, assignees, etc, from the system.

If custom configuration is enabled for the organization, custom field values will be returned as part of the observation.

request

GET /api/v1/organization/a942fd23-0674-4109-96e0-e20c223eec64/project/ds5987dfasd659sd7/observation/AF1256FADMQ3F?useExternalId=true HTTP/1.1
Host: public-api.smartvid.io

Table 6. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/observation/{observationOrExternalObservationId}
Parameter	Description
`organizationId`	Internal ID of the organization
`projectOrExternalProjectId`	ID of project
`observationOrExternalObservationId`	ID of observation

Table 7. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId and observationId will expect external IDs

Table 8. response fields description
Path	Type	Description
`observationId`	`String`	Internal ID of the observation
`projectId`	`String`	Internal ID of the project
`status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`hazardCategory`	`String`	Hazard category
`identificationMethod`	`String`	Method of identification
`notes`	`String`	Observation notes
`severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`risk`	`Number`	Calculated risk of the observation
`recommendedAction`	`String`	Recommended action
`reviewComment`	`String`	Review comment for observation
`userFriendlyId`	`String`	User-friendly observation ID in format - SO-id
`externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`externalObservationId`	`String`	External observation ID provided for observation, used for observation lookup
`dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`createdDate`	`String`	Creation date of the observation. Date format is in ISO 8601
`updatedDate`	`String`	Update date of the observation. Date format is in ISO 8601
`closedDate`	`String`	Closed date of the observation. Date format is in ISO 8601
`reviewedDate`	`String`	Reviewed date of the observation. Date format is in ISO 8601
`type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`isGreatCatch`	`Boolean`	Is this observation a great catch
`actionTaken`	`String`	Action taken
`createdByUser`	`Object`	User who created observation
`createdByUser.id`	`String`	Internal ID of user
`createdByUser.firstName`	`String`	First name of user
`createdByUser.lastName`	`String`	Last name of user
`createdByUser.email`	`String`	Email of user
`createdByUser.isActive`	`Boolean`	The indicator if the given user is active
`createdByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`createdByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`assignedToUser`	`Object`	User who was assigned observation
`assignedToUser.id`	`String`	Internal ID of user
`assignedToUser.firstName`	`String`	First name of user
`assignedToUser.lastName`	`String`	Last name of user
`assignedToUser.email`	`String`	Email of user
`assignedToUser.isActive`	`Boolean`	The indicator if the given user is active
`assignedToUser.isInvited`	`Boolean`	The indicator if the given user is invited
`assignedToUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`closedByUser`	`Object`	User who closed observation
`closedByUser.id`	`String`	Internal ID of user
`closedByUser.firstName`	`String`	First name of user
`closedByUser.lastName`	`String`	Last name of user
`closedByUser.email`	`String`	Email of user
`closedByUser.isActive`	`Boolean`	The indicator if the given user is active
`closedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`closedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`updatedByUser`	`Object`	User who last updated observation
`updatedByUser.id`	`String`	Internal ID of user
`updatedByUser.firstName`	`String`	First name of user
`updatedByUser.lastName`	`String`	Last name of user
`updatedByUser.email`	`String`	Email of user
`updatedByUser.isActive`	`Boolean`	The indicator if the given user is active
`updatedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`updatedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`reviewedByUser`	`Object`	User who reviewed observation
`reviewedByUser.id`	`String`	Internal ID of user
`reviewedByUser.firstName`	`String`	First name of user
`reviewedByUser.lastName`	`String`	Last name of user
`reviewedByUser.email`	`String`	Email of user
`reviewedByUser.isActive`	`Boolean`	The indicator if the given user is active
`reviewedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`reviewedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`tradePartnerId`	`String`	ID of Trade Partner associated with observation
`customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`customFields[].id`	`String`	Id of the custom field value
`customFields[].identifier`	`String`	Identifier of the custom field value
`customFields[].dataType`	`String`	Data type of the custom field value
`customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2546

{
  "observationId" : "83caea37-2c95-437b-a6e3-ea751add538a",
  "projectId" : "3ef8fd78-aac3-4997-8de6-ad618db4ef8c",
  "status" : "NEW",
  "hazardCategory" : "Sample hazard category",
  "identificationMethod" : "Sample identification method",
  "notes" : "Sample observation note",
  "severity" : "CRITICAL",
  "frequency" : "DAILY",
  "risk" : 25.0,
  "recommendedAction" : "Sample recommended action",
  "reviewComment" : "Sample review comment",
  "dueDate" : "2024-04-10T10:08:35.407+0000",
  "createdDate" : "2024-04-10T10:08:35.451+0000",
  "updatedDate" : "2024-04-10T10:08:35.451+0000",
  "closedDate" : "2024-04-10T10:08:35.407+0000",
  "reviewedDate" : "2024-04-10T10:08:35.407+0000",
  "type" : "NEGATIVE",
  "isGreatCatch" : true,
  "actionTaken" : "Test action taken",
  "externalId" : 1,
  "userFriendlyId" : "SO-1",
  "externalObservationId" : "AF1256FADMQ3F",
  "customFields" : [ {
    "id" : "888258ef-7c8e-4bd4-9a9e-07f031b6f870",
    "identifier" : "longField",
    "dataType" : "LONG",
    "valueLong" : 999999
  }, {
    "id" : "8087dacb-30e3-4af6-8c71-1bd92c6f33d3",
    "identifier" : "realField",
    "dataType" : "REAL",
    "valueReal" : 1.99
  }, {
    "id" : "e8cd95fa-b7e3-4eaa-b2e3-9994188bb501",
    "identifier" : "dateField",
    "dataType" : "DATE",
    "valueDate" : "2024-04-10T10:08:35.408+0000"
  }, {
    "id" : "9c98c872-e97f-4804-8131-3905dee59b84",
    "identifier" : "booleanField",
    "dataType" : "BOOLEAN",
    "valueBoolean" : true
  } ],
  "createdByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "assignedToUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "updatedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "closedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "reviewedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "tradePartnerId" : "ddb6ff71-aa26-40e6-a570-a4ade5e8e9fc"
}

Create Observations API

Create Observations API can be used to import a list of observations into the system. Create Observations API accepts file names and URLs for downloading and associating images with observations

request

POST /api/v1/organization/52877831-b274-434c-acd7-04e60e0ff01d/project/ds5987dfasd659sd7/observation?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 1614

{
  "observations" : [ {
    "tradePartnerId" : "fhsdfh87s5sdf7a8eh",
    "assignedUserId" : "1",
    "assignedUserEmail" : "admin@smartvid.io",
    "status" : "NEW",
    "closedByUserId" : "1",
    "reviewedByUserId" : "1",
    "hazardCategory" : "Sample hazard category",
    "identificationMethod" : "Sample identification method",
    "notes" : "Sample observation notes",
    "severity" : "MEDIUM",
    "frequency" : "MONTHLY",
    "risk" : 25.0,
    "recommendedAction" : "Sample recommended action",
    "dueDate" : "2024-04-10T10:08:37.221Z",
    "closedDate" : "2024-04-10T10:08:37.221Z",
    "reviewedDate" : "2024-04-10T10:08:37.221Z",
    "type" : "NEGATIVE",
    "isGreatCatch" : false,
    "actionTaken" : "Sample action taken",
    "externalId" : 4810492,
    "externalObservationId" : "578sf6578s6fdq2",
    "reviewComment" : "Sample review comment",
    "customFields" : [ {
      "identifier" : "testCustomField",
      "dataType" : "STRING",
      "valueString" : "test value"
    } ],
    "projectId" : "ds5987dfasd659sd7",
    "createdTime" : "2024-04-10T10:08:37.221Z",
    "createdByUserId" : "1",
    "updatedTime" : "2024-04-10T10:08:37.221Z",
    "updatedByUserId" : "1"
  }, {
    "status" : "NEW",
    "notes" : "Sample observation notes",
    "severity" : "MEDIUM",
    "frequency" : "MONTHLY",
    "risk" : 25.0,
    "type" : "NEGATIVE",
    "externalId" : 0,
    "customFields" : [ ],
    "projectId" : "ds5987dfasd659sd7",
    "filesToDownload" : [ {
      "url" : "https://test-data.s3-us-west-2.amazonaws.com/Images/example.jpeg",
      "fileName" : "example.jpeg"
    } ]
  } ]
}

Table 9. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/observation
Parameter	Description
`organizationId`	Internal ID of the organization
`projectOrExternalProjectId`	ID of project

Table 10. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId, observationId, and tradePartnerId will expect external IDs

Table 11. request body
Path	Type	Description
`observations[].projectId`	`String`	Internal ID of the project
`observations[].status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`observations[].hazardCategory`	`String`	Hazard category
`observations[].identificationMethod`	`String`	Method of identification
`observations[].notes`	`String`	Observation notes
`observations[].severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`observations[].frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`observations[].risk`	`Number`	Calculated risk of the observation
`observations[].recommendedAction`	`String`	Recommended action
`observations[].reviewComment`	`String`	Review comment for observation
`observations[].dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`observations[].closedDate`	`String`	Closed date for the observation. Date format is in ISO 8601
`observations[].reviewedDate`	`String`	Reviewed date for the observation. Date format is in ISO 8601
`observations[].type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`observations[].isGreatCatch`	`Boolean`	Is this observation a great catch
`observations[].actionTaken`	`String`	Action taken
`observations[].assignedUserId`	`String`	ID of user who was assigned observation
`observations[].assignedUserEmail`	`String`	Email of user who was assigned observation
`observations[].createdByUserId`	`String`	ID of user who created an observation
`observations[].createdTime`	`String`	Created time for the observation. Date format is in ISO 8601
`observations[].updatedByUserId`	`String`	ID of user who updated the observation
`observations[].updatedTime`	`String`	Updated time for the observation. Date format is in ISO 8601
`observations[].closedByUserId`	`String`	ID of user who closed observation
`observations[].reviewedByUserId`	`String`	ID of user who reviewed observation
`observations[].tradePartnerId`	`String`	ID of Trade Partner associated with observation
`observations[].externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`observations[].externalObservationId`	`String`	External observation ID provided for observation, used for observation lookup
`observations[].filesToDownload[].url`	`String`	URL of file to download
`observations[].filesToDownload[].fileName`	`String`	Name of file to download
`observations[].customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`observations[].customFields[].id`	`String`	Id of the custom field value
`observations[].customFields[].identifier`	`String`	Identifier of the custom field value
`observations[].customFields[].dataType`	`String`	Data type of the custom field value
`observations[].customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`observations[].customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`observations[].customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`observations[].customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`observations[].customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

Table 12. response fields description
Path	Type	Description
`observations[].observationId`	`String`	Internal ID of the observation
`observations[].projectId`	`String`	Internal ID of the project
`observations[].status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`observations[].hazardCategory`	`String`	Hazard category
`observations[].identificationMethod`	`String`	Method of identification
`observations[].notes`	`String`	Observation notes
`observations[].severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`observations[].frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`observations[].risk`	`Number`	Calculated risk of the observation
`observations[].recommendedAction`	`String`	Recommended action
`observations[].reviewComment`	`String`	Review comment for observation
`observations[].userFriendlyId`	`String`	User-friendly observation ID in format - SO-id
`observations[].externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`observations[].externalObservationId`	`String`	External observation ID provided for observation, used for observation lookup
`observations[].dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`observations[].createdDate`	`String`	Creation date of the observation. Date format is in ISO 8601
`observations[].updatedDate`	`String`	Update date of the observation. Date format is in ISO 8601
`observations[].closedDate`	`String`	Closed date of the observation. Date format is in ISO 8601
`observations[].reviewedDate`	`String`	Reviewed date of the observation. Date format is in ISO 8601
`observations[].type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`observations[].isGreatCatch`	`Boolean`	Is this observation a great catch
`observations[].actionTaken`	`String`	Action taken
`observations[].createdByUser`	`Object`	User who created observation
`observations[].createdByUser.id`	`String`	Internal ID of user
`observations[].createdByUser.firstName`	`String`	First name of user
`observations[].createdByUser.lastName`	`String`	Last name of user
`observations[].createdByUser.email`	`String`	Email of user
`observations[].createdByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].createdByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].createdByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].assignedToUser`	`Object`	User who was assigned observation
`observations[].assignedToUser.id`	`String`	Internal ID of user
`observations[].assignedToUser.firstName`	`String`	First name of user
`observations[].assignedToUser.lastName`	`String`	Last name of user
`observations[].assignedToUser.email`	`String`	Email of user
`observations[].assignedToUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].assignedToUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].assignedToUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].closedByUser`	`Object`	User who closed observation
`observations[].closedByUser.id`	`String`	Internal ID of user
`observations[].closedByUser.firstName`	`String`	First name of user
`observations[].closedByUser.lastName`	`String`	Last name of user
`observations[].closedByUser.email`	`String`	Email of user
`observations[].closedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].closedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].closedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].updatedByUser`	`Object`	User who last updated observation
`observations[].updatedByUser.id`	`String`	Internal ID of user
`observations[].updatedByUser.firstName`	`String`	First name of user
`observations[].updatedByUser.lastName`	`String`	Last name of user
`observations[].updatedByUser.email`	`String`	Email of user
`observations[].updatedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].updatedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].updatedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].reviewedByUser`	`Object`	User who reviewed observation
`observations[].reviewedByUser.id`	`String`	Internal ID of user
`observations[].reviewedByUser.firstName`	`String`	First name of user
`observations[].reviewedByUser.lastName`	`String`	Last name of user
`observations[].reviewedByUser.email`	`String`	Email of user
`observations[].reviewedByUser.isActive`	`Boolean`	The indicator if the given user is active
`observations[].reviewedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`observations[].reviewedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`observations[].tradePartnerId`	`String`	ID of Trade Partner associated with observation
`observations[].customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`observations[].customFields[].id`	`String`	Id of the custom field value
`observations[].customFields[].identifier`	`String`	Identifier of the custom field value
`observations[].customFields[].dataType`	`String`	Data type of the custom field value
`observations[].customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`observations[].customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`observations[].customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`observations[].customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`observations[].customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

sample response

HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 3241

{
  "observations" : [ {
    "observationId" : "11cb8c62-3b02-4572-8356-aa470b302f67",
    "projectId" : "1628bfd5-5ca5-4690-a789-76bccea95d66",
    "status" : "NEW",
    "hazardCategory" : "Sample hazard category",
    "identificationMethod" : "Sample identification method",
    "notes" : "Sample observation notes",
    "severity" : "MEDIUM",
    "frequency" : "MONTHLY",
    "risk" : 6.0,
    "recommendedAction" : "Sample recommended action",
    "reviewComment" : "Sample review comment",
    "dueDate" : "2024-04-10T10:08:37.221+0000",
    "createdDate" : "2024-04-10T10:08:37.221+0000",
    "updatedDate" : "2024-04-10T10:08:37.221+0000",
    "closedDate" : "2024-04-10T10:08:37.221+0000",
    "reviewedDate" : "2024-04-10T10:08:37.221+0000",
    "type" : "NEGATIVE",
    "isGreatCatch" : false,
    "actionTaken" : "Sample action taken",
    "externalId" : 4810492,
    "userFriendlyId" : "SO-4810492",
    "externalObservationId" : "578sf6578s6fdq2",
    "customFields" : [ {
      "id" : "1e95a189-048a-4eed-b1b0-1249b0b79377",
      "identifier" : "testCustomField",
      "dataType" : "STRING",
      "valueString" : "test value"
    } ],
    "createdByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "assignedToUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "updatedByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "closedByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "reviewedByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "tradePartnerId" : "cc629d02-8265-4f49-8541-539284ffaa07"
  }, {
    "observationId" : "ad9dbed0-00e0-4c7e-8300-8d70ac9de4f4",
    "projectId" : "1628bfd5-5ca5-4690-a789-76bccea95d66",
    "status" : "NEW",
    "notes" : "Sample observation notes",
    "severity" : "MEDIUM",
    "frequency" : "MONTHLY",
    "risk" : 6.0,
    "createdDate" : "2024-04-10T10:08:37.583+0000",
    "updatedDate" : "2024-04-10T10:08:37.583+0000",
    "type" : "NEGATIVE",
    "isGreatCatch" : false,
    "externalId" : 2,
    "userFriendlyId" : "SO-2",
    "customFields" : [ ],
    "createdByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    },
    "updatedByUser" : {
      "id" : "1",
      "firstName" : "Admin",
      "lastName" : "Admin",
      "email" : "admin@smartvid.io",
      "isActive" : true,
      "isInvited" : false,
      "isSso" : false
    }
  } ]
}

Update Observation API

Update Observation API can be used to update an observations in the system. Update Observation API requires the full observation object be sent with desired fields updated. For existing observation the following fields cannot be updated: id, projectId and externalObservationId.

request

PUT /api/v1/organization/de328494-6fe1-432b-a7d1-ef9646a16010/project/ds5987dfasd659sd7/observation/AF1256FADMQ3F?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 878

{
  "tradePartnerId" : "fhsdfh87s5sdf7a8eh",
  "assignedUserId" : "1",
  "assignedUserEmail" : "admin@smartvid.io",
  "status" : "CLOSED",
  "closedByUserId" : "1",
  "reviewedByUserId" : "1",
  "hazardCategory" : "Sample hazard category",
  "identificationMethod" : "Sample identification method",
  "notes" : "Sample observation notes",
  "severity" : "MEDIUM",
  "frequency" : "MONTHLY",
  "risk" : 25.0,
  "recommendedAction" : "Sample recommended action",
  "dueDate" : "2024-04-10T10:08:39.058Z",
  "closedDate" : "2024-04-10T10:08:39.058Z",
  "reviewedDate" : "2024-04-10T10:08:39.058Z",
  "type" : "NEGATIVE",
  "isGreatCatch" : false,
  "actionTaken" : "Sample action taken",
  "externalId" : 4810492,
  "reviewComment" : "Sample review comment",
  "customFields" : [ ],
  "updatedTime" : "2024-04-10T10:08:39.058Z",
  "updatedByUserId" : "1",
  "fieldsToClear" : [ ]
}

Table 13. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/observation/{observationOrExternalObservationId}
Parameter	Description
`organizationId`	Internal ID of the organization
`projectOrExternalProjectId`	ID of project
`observationOrExternalObservationId`	ID of observation

Table 14. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId, observationId, and tradePartnerId will expect external IDs

Table 15. request body
Path	Type	Description
`status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`hazardCategory`	`String`	Hazard category
`identificationMethod`	`String`	Method of identification
`notes`	`String`	Observation notes
`severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`risk`	`Number`	Calculated risk of the observation
`recommendedAction`	`String`	Recommended action
`reviewComment`	`String`	Review comment for observation
`dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`closedDate`	`String`	Closed date for the observation. Date format is in ISO 8601
`reviewedDate`	`String`	Reviewed date for the observation. Date format is in ISO 8601
`type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`isGreatCatch`	`Boolean`	Is this observation a great catch
`actionTaken`	`String`	Action taken
`assignedUserId`	`String`	ID of user who was assigned observation
`assignedUserEmail`	`String`	Email of user who was assigned observation
`updatedByUserId`	`String`	ID of user who last updated observation
`updatedTime`	`String`	Updated date for the observation. Date format is in ISO 8601
`closedByUserId`	`String`	ID of user who closed observation
`reviewedByUserId`	`String`	ID of user who reviewed observation
`tradePartnerId`	`String`	ID of Trade Partner associated with observation
`externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "tradePartnerId", "assignedUserId", "hazardCategory", "identificationMethod", "recommendedAction", "dueDate", "isGreatCatch", "actionTaken", "externalId", "reviewComment", "closedDate", "externalObservationId", "reviewedByUserId", "closedByUserId", "reviewedDate", "updatedTime", "updatedByUserId"
`customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`customFields[].id`	`String`	Id of the custom field value
`customFields[].identifier`	`String`	Identifier of the custom field value
`customFields[].dataType`	`String`	Data type of the custom field value
`customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

Table 16. response fields description
Path	Type	Description
`observationId`	`String`	Internal ID of the observation
`projectId`	`String`	Internal ID of the project
`status`	`String`	Status of the observation. Can have one of the following values NEW,IN_PROGRESS,WITH_PARTNER,DELAYED,CLOSED,READY_TO_REVIEW,CLOSED_REVIEWED,OBSERVED,NOT_APPLICABLE
`hazardCategory`	`String`	Hazard category
`identificationMethod`	`String`	Method of identification
`notes`	`String`	Observation notes
`severity`	`String`	Observation severity. Can have one of the following values NA,LOW,MEDIUM,HIGH,CRITICAL,LOSS_OF_LIFE
`frequency`	`String`	Observation frequency. Can have one of the following values NA,UNLIKELY,ANNUALLY,MONTHLY,WEEKLY,DAILY
`risk`	`Number`	Calculated risk of the observation
`recommendedAction`	`String`	Recommended action
`reviewComment`	`String`	Review comment for observation
`userFriendlyId`	`String`	User-friendly observation ID in format - SO-id
`externalId`	`Number`	External ID provided for observation, for informational purpose only, not used for observation lookup
`externalObservationId`	`String`	External observation ID provided for observation, used for observation lookup
`dueDate`	`String`	Due date for the observation. Date format is in ISO 8601
`createdDate`	`String`	Creation date of the observation. Date format is in ISO 8601
`updatedDate`	`String`	Update date of the observation. Date format is in ISO 8601
`closedDate`	`String`	Closed date of the observation. Date format is in ISO 8601
`reviewedDate`	`String`	Reviewed date for the observation. Date format is in ISO 8601
`type`	`String`	Type of the observation. Can have one of the following values POSITIVE,NEGATIVE
`isGreatCatch`	`Boolean`	Is this observation a great catch
`actionTaken`	`String`	Action taken
`createdByUser`	`Object`	User who created observation
`createdByUser.id`	`String`	Internal ID of user
`createdByUser.firstName`	`String`	First name of user
`createdByUser.lastName`	`String`	Last name of user
`createdByUser.email`	`String`	Email of user
`createdByUser.isActive`	`Boolean`	The indicator if the given user is active
`createdByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`createdByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`assignedToUser`	`Object`	User who was assigned observation
`assignedToUser.id`	`String`	Internal ID of user
`assignedToUser.firstName`	`String`	First name of user
`assignedToUser.lastName`	`String`	Last name of user
`assignedToUser.email`	`String`	Email of user
`assignedToUser.isActive`	`Boolean`	The indicator if the given user is active
`assignedToUser.isInvited`	`Boolean`	The indicator if the given user is invited
`assignedToUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`closedByUser`	`Object`	User who closed observation
`closedByUser.id`	`String`	Internal ID of user
`closedByUser.firstName`	`String`	First name of user
`closedByUser.lastName`	`String`	Last name of user
`closedByUser.email`	`String`	Email of user
`closedByUser.isActive`	`Boolean`	The indicator if the given user is active
`closedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`closedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`updatedByUser`	`Object`	User who last updated observation
`updatedByUser.id`	`String`	Internal ID of user
`updatedByUser.firstName`	`String`	First name of user
`updatedByUser.lastName`	`String`	Last name of user
`updatedByUser.email`	`String`	Email of user
`updatedByUser.isActive`	`Boolean`	The indicator if the given user is active
`updatedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`updatedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`reviewedByUser`	`Object`	User who reviewed observation
`reviewedByUser.id`	`String`	Internal ID of user
`reviewedByUser.firstName`	`String`	First name of user
`reviewedByUser.lastName`	`String`	Last name of user
`reviewedByUser.email`	`String`	Email of user
`reviewedByUser.isActive`	`Boolean`	The indicator if the given user is active
`reviewedByUser.isInvited`	`Boolean`	The indicator if the given user is invited
`reviewedByUser.isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`tradePartnerId`	`String`	ID of Trade Partner associated with observation
`customFields[]`	`Array`	Custom fields for a given observation, when custom fields are configured for the organization
`customFields[].id`	`String`	Id of the custom field value
`customFields[].identifier`	`String`	Identifier of the custom field value
`customFields[].dataType`	`String`	Data type of the custom field value
`customFields[].valueLong`	`Number`	Value of the custom field, when its data type is LONG
`customFields[].valueReal`	`Number`	Value of the custom field, when its data type is REAL
`customFields[].valueBoolean`	`Boolean`	Value of the custom field, when its data type is BOOLEAN
`customFields[].valueDate`	`String`	Value of the custom field, when its data type is DATE. Date format is in ISO 8601
`customFields[].valueString`	`String`	Value of the custom field, when its data type is STRING

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 2552

{
  "observationId" : "25bfaeb3-3f9c-4e04-93f5-43271f5e45a1",
  "projectId" : "bbaedf30-fd73-42da-a86e-07dbd80b91ec",
  "status" : "CLOSED",
  "hazardCategory" : "Sample hazard category",
  "identificationMethod" : "Sample identification method",
  "notes" : "Sample observation notes",
  "severity" : "MEDIUM",
  "frequency" : "MONTHLY",
  "risk" : 6.0,
  "recommendedAction" : "Sample recommended action",
  "reviewComment" : "Sample review comment",
  "dueDate" : "2024-04-10T10:08:39.058+0000",
  "createdDate" : "2024-04-10T10:08:38.540+0000",
  "updatedDate" : "2024-04-10T10:08:39.058+0000",
  "closedDate" : "2024-04-10T10:08:39.058+0000",
  "reviewedDate" : "2024-04-10T10:08:39.058+0000",
  "type" : "NEGATIVE",
  "isGreatCatch" : false,
  "actionTaken" : "Sample action taken",
  "externalId" : 1,
  "userFriendlyId" : "SO-1",
  "externalObservationId" : "AF1256FADMQ3F",
  "customFields" : [ {
    "id" : "b2dbed14-9d32-4533-8399-500a01fc15f4",
    "identifier" : "longField",
    "dataType" : "LONG",
    "valueLong" : 999999
  }, {
    "id" : "156f54b7-ab86-4bde-aee2-1450dc6bf68b",
    "identifier" : "realField",
    "dataType" : "REAL",
    "valueReal" : 1.99
  }, {
    "id" : "0565a122-6780-4432-b092-29ec7294fa66",
    "identifier" : "dateField",
    "dataType" : "DATE",
    "valueDate" : "2024-04-10T10:08:38.491+0000"
  }, {
    "id" : "55a04edd-c411-49b6-8e53-37b40227a18b",
    "identifier" : "booleanField",
    "dataType" : "BOOLEAN",
    "valueBoolean" : true
  } ],
  "createdByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "assignedToUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "updatedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "closedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "reviewedByUser" : {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  },
  "tradePartnerId" : "5bc8b563-9843-4470-82d1-83a43db43c6c"
}

Delete Observation API

Delete Observation API can be used to delete an observations from the system.

request

DELETE /api/v1/organization/6d38d82c-9159-4b8b-97be-4ad49550edc0/project/ds5987dfasd659sd7/observation/AF1256FADMQ3F?useExternalId=true HTTP/1.1
Host: public-api.smartvid.io

Table 17. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/observation/{observationOrExternalObservationId}
Parameter	Description
`organizationId`	Internal ID of the organization
`projectOrExternalProjectId`	ID of project
`observationOrExternalObservationId`	ID of observation

Table 18. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId and observationId will expect external IDs

sample response

HTTP/1.1 204 No Content

Get Failed Download Files For Observation API

Get Failed Download Files For Observation API can be used to retrieve a list of files that failed to download into the system for a particular observation.

request

GET /api/v1/organization/9e6eefb8-4ade-4ebb-bcb4-b89785e227b2/project/ds5987dfasd659sd7/observation/AF1256FADMQ3F/download/status/failed?useExternalId=true HTTP/1.1
Host: public-api.smartvid.io

Table 19. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/observation/{observationOrExternalObservationId}/download/status/failed
Parameter	Description
`organizationId`	Internal ID of the organization
`projectOrExternalProjectId`	ID of project
`observationOrExternalObservationId`	ID of observation

Table 20. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId and observationId will expect external IDs

Table 21. response fields description
Path	Type	Description
`failedDownloads[].id`	`String`	Internal ID of download job
`failedDownloads[].fileName`	`String`	Name of file
`failedDownloads[].url`	`String`	URL of file

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 264

{
  "failedDownloads" : [ {
    "id" : "1b67a2dc-0f30-4334-b826-5d41df371204",
    "fileName" : "test2.jpg",
    "url" : "http://test2.us"
  }, {
    "id" : "14d1ec44-682a-4123-b686-59a4839ca461",
    "fileName" : "test1.jpg",
    "url" : "http://test1.us"
  } ]
}

Projects

Sync Projects API

Sync Project API is used to create new or update existing projects in Newmetrix.
The organizationId path parameter must match to all of the organizationId’s in the payload, this means that user can sync only the projects from a single organization in a single call to this API.
The system will try to locate existing projects based on the projectExternalId or id depending on the value of the useExternalId parameter.
For existing projects only the following fields can be updated: name, description, location and projectNumber.
The API is limited to work with 100 projects at a time.
User calling this API must have permission to manage projects for each projects' organization specified.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.

request

POST /api/v1/organization/a89ce134-0857-4383-a084-8ce670d57693/project/sync?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 2836

{
  "projects" : [ {
    "name" : "name1_UPD",
    "projectNumber" : "Project X 1",
    "externalProjectId" : "EXT_P1",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "description" : "descr1_UPD",
    "location" : "loc1_UPD",
    "users" : [ {
      "email" : "user1email",
      "roles" : [ {
        "roleName" : "COLLABORATOR",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    }, {
      "email" : "user2email",
      "roles" : [ {
        "roleName" : "RECEIVER",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    } ],
    "fieldsToClear" : [ ]
  }, {
    "name" : "name2_UPD",
    "projectNumber" : "Project X 2",
    "externalProjectId" : "EXT_P2",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "location" : "loc2_UPD",
    "users" : [ {
      "email" : "user1email",
      "roles" : [ {
        "roleName" : "COLLABORATOR",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    }, {
      "email" : "user2email",
      "roles" : [ {
        "roleName" : "RECEIVER",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    } ],
    "fieldsToClear" : [ "description" ]
  }, {
    "name" : "name_new",
    "externalProjectId" : "EXT_NEW_P_ID",
    "projectGroupId" : "60e5753d-4323-42cb-905a-71f4afa59f3b",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "description" : "descr_new",
    "location" : "loc_new",
    "users" : [ {
      "email" : "user1email",
      "roles" : [ {
        "roleName" : "COLLABORATOR",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    }, {
      "email" : "user2email",
      "roles" : [ {
        "roleName" : "RECEIVER",
        "moduleType" : "ASSETS"
      }, {
        "roleName" : "SAFETY_COLLABORATOR",
        "moduleType" : "OBSERVATIONS"
      }, {
        "roleName" : "TRADE_PARTNER_ADMIN",
        "moduleType" : "TRADE_PARTNERS"
      } ]
    } ],
    "projectType" : "COMMERCIAL",
    "fieldsToClear" : [ ]
  } ]
}

Table 22. /api/v1/organization/{organizationId}/project/sync
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to

Table 23. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

Table 24. request body
Path	Type	Description
`projects[].projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`projects[].startDate`	`String`	Start date of the project
`projects[].endDate`	`String`	End date of the project
`projects[].longitude`	`Number`	Longitude of the project
`projects[].latitude`	`Number`	Latitude of the project
`projects[].budget`	`Number`	Project’s budget ($)
`projects[].addressLine1`	`String`	Project’s address
`projects[].city`	`String`	Project’s city
`projects[].postalCode`	`String`	Project’s postal code
`projects[].state`	`String`	Project’s state
`projects[].country`	`String`	Project’s country
`projects[].id`	`String`	The internal ID of the project
`projects[].externalProjectId`	`String`	The ID of the project in the external system
`projects[].projectNumber`	`String`	The human readable project identifier
`projects[].projectGroupId`	`String`	The internal ID of the project group for this project
`projects[].organizationId`	`String`	The internal ID of the organization this project belongs to. This is a required field
`projects[].name`	`String`	The name of the project. This field is required for any new project
`projects[].description`	`String`	The description of the project
`projects[].location`	`String`	Location of the project
`projects[].fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "description", "location", "projectNumber", "projectType", "startDate", "endDate", "longitude", "latitude", "budget", "addressLine1", "city", "postalCode", "state", "country"
`projects[].users[].email`	`String`	The e-mail address of the existing smartvid user
`projects[].users[].roles[].roleName`	`String`	The user’s role for the current project
`projects[].users[].roles[].moduleType`	`String`	The module to which the user will be invited with the given role for the give project

Table 25. response fields description
Path	Type	Description
`projects[].projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`projects[].startDate`	`String`	Start date of the project
`projects[].endDate`	`String`	End date of the project
`projects[].longitude`	`Number`	Longitude of the project
`projects[].latitude`	`Number`	Latitude of the project
`projects[].budget`	`Number`	Project’s budget ($)
`projects[].addressLine1`	`String`	Project’s address
`projects[].city`	`String`	Project’s city
`projects[].postalCode`	`String`	Project’s postal code
`projects[].state`	`String`	Project’s state
`projects[].country`	`String`	Project’s country
`projects[].id`	`String`	The internal ID of the project
`projects[].externalProjectId`	`String`	The ID of the project in the external system
`projects[].projectNumber`	`String`	The human readable project identifier
`projects[].projectGroupId`	`String`	The internal ID of the project group for this project
`projects[].inactive`	`Boolean`	Whether project is inactive or active
`projects[].organizationId`	`String`	The internal ID of the organization this project belongs to
`projects[].name`	`String`	The name of the project
`projects[].description`	`String`	The description of the project
`projects[].location`	`String`	The location of the project

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 968

{
  "projects" : [ {
    "id" : "0a4b71d6-0072-45a5-b152-b81aa2e9545c",
    "externalProjectId" : "EXT_NEW_P_ID",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "name" : "name_new",
    "description" : "descr_new",
    "location" : "loc_new",
    "projectGroupId" : "60e5753d-4323-42cb-905a-71f4afa59f3b",
    "inactive" : false,
    "projectType" : "COMMERCIAL"
  }, {
    "id" : "59828d3a-9a92-4684-a518-defe66a8abf2",
    "projectNumber" : "Project X 1",
    "externalProjectId" : "EXT_P1",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "name" : "name1_UPD",
    "description" : "descr1_UPD",
    "location" : "loc1_UPD",
    "inactive" : false
  }, {
    "id" : "75fef901-b3c3-449d-b64e-7e8c61b75245",
    "projectNumber" : "Project X 2",
    "externalProjectId" : "EXT_P2",
    "organizationId" : "a89ce134-0857-4383-a084-8ce670d57693",
    "name" : "name2_UPD",
    "location" : "loc2_UPD",
    "inactive" : false
  } ]
}

Update Project’s external ID API

Update Project’s external ID API is used to update an external ID of an existing project in Newmetrix.
User calling this API must have permission to manage projects in the organization to which the project belongs to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed or in case where the project with a given external ID already exists in the given organization the response code 400 is returned.
To set an external ID for the project that doesn’t have one, omit the oldId field in the request payload.
For any permission related errors the response code 401 is returned.
If project cannot be found the response code 404 is returned.

request

PATCH /api/v1/organization/cb961533-8a99-4839-be1a-1b95e2eaf423/project/1a8cce19-233f-436c-8d15-2225a577e371/externalId HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 50

{
  "oldId" : "EXT_P1",
  "newId" : "EXT_UPD_P1"
}

Table 26. /api/v1/organization/{organizationId}/project/{internalProjectId}/externalId
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`internalProjectId`	The internal ID of the project for which an external ID needs to be updated

Table 27. request body
Path	Type	Description
`oldId`	`String`	The old external ID (optional) of an existing project
`newId`	`String`	The new external ID for an existing project

Table 28. response fields description
Path	Type	Description
`projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`startDate`	`String`	Start date of the project
`endDate`	`String`	End date of the project
`longitude`	`Number`	Longitude of the project
`latitude`	`Number`	Latitude of the project
`budget`	`Number`	Project’s budget ($)
`addressLine1`	`String`	Project’s address
`city`	`String`	Project’s city
`postalCode`	`String`	Project’s postal code
`state`	`String`	Project’s state
`country`	`String`	Project’s country
`id`	`String`	The internal ID of the project
`externalProjectId`	`String`	The ID of the project in the external system, must be unique within the organization
`projectNumber`	`String`	The human readable project identifier
`organizationId`	`String`	The internal ID of the organization this project belongs to
`name`	`String`	The name of the project
`description`	`String`	The description of the project
`location`	`String`	The location of the project
`projectGroupId`	`String`	ID of the project group that this project belongs to
`inactive`	`Boolean`	Whether project is inactive or active

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 189

{
  "id" : "1a8cce19-233f-436c-8d15-2225a577e371",
  "externalProjectId" : "EXT_UPD_P1",
  "organizationId" : "cb961533-8a99-4839-be1a-1b95e2eaf423",
  "name" : "P1",
  "inactive" : false
}

Update Project’s Project Group

Update Project’s Project Group ID API is used to update a project group ID of an existing project in Newmetrix.
User calling this API must have permission to manage projects in the source and target project groups
Upon successful execution the API returns response payload along with 200 response code.
For any permission related errors the response code 401 is returned.
If project cannot be found the response code 404 is returned.

request

PATCH /api/v1/organization/85a62c2e-339c-4599-ad51-a934a9fd629c/project/EXT_P1/projectGroupId?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 54

{
  "newId" : "8211c48e-dbcc-4f0d-ac1e-5c855e4934db"
}

Table 29. /api/v1/organization/{organizationId}/project/{projectId}/projectGroupId
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`projectId`	The ID of the project for which a project group ID needs to be updated (internal or external, specified in the request

Table 30. request body
Path	Type	Description
`newId`	`String`	The new project group ID

Table 31. response fields description
Path	Type	Description
`projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`startDate`	`String`	Start date of the project
`endDate`	`String`	End date of the project
`longitude`	`Number`	Longitude of the project
`latitude`	`Number`	Latitude of the project
`budget`	`Number`	Project’s budget ($)
`addressLine1`	`String`	Project’s address
`city`	`String`	Project’s city
`postalCode`	`String`	Project’s postal code
`state`	`String`	Project’s state
`country`	`String`	Project’s country
`id`	`String`	The internal ID of the project
`externalProjectId`	`String`	The ID of the project in the external system, must be unique within the organization
`projectNumber`	`String`	The human readable project identifier
`organizationId`	`String`	The internal ID of the organization this project belongs to
`name`	`String`	The name of the project
`description`	`String`	The description of the project
`location`	`String`	The location of the project
`projectGroupId`	`String`	ID of the project group that this project belongs to
`inactive`	`Boolean`	Whether project is inactive or active

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 246

{
  "id" : "2c180215-129c-4180-b921-e808b0d40403",
  "externalProjectId" : "EXT_P1",
  "organizationId" : "85a62c2e-339c-4599-ad51-a934a9fd629c",
  "name" : "P1",
  "projectGroupId" : "8211c48e-dbcc-4f0d-ac1e-5c855e4934db",
  "inactive" : false
}

Get Project API

Get Project API is used to get an existing project from Newmetrix.
The project is retrieved based on the projectExternalId or id depending on the value of the useExternalId parameter.
User calling this API must have permission to access the organization to which the project belongs to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If project cannot be found the response code 404 is returned.

request

GET /api/v1/organization/26032ced-fec9-4d6e-b9c7-4d99f1a61113/project/EXT_P1?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 32. /api/v1/organization/{organizationId}/project/{projectId}
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 33. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

Table 34. response fields description
Path	Type	Description
`projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`startDate`	`String`	Start date of the project
`endDate`	`String`	End date of the project
`longitude`	`Number`	Longitude of the project
`latitude`	`Number`	Latitude of the project
`budget`	`Number`	Project’s budget ($)
`addressLine1`	`String`	Project’s address
`city`	`String`	Project’s city
`postalCode`	`String`	Project’s postal code
`state`	`String`	Project’s state
`country`	`String`	Project’s country
`id`	`String`	The internal ID of the project
`externalProjectId`	`String`	The ID of the project in the external system
`projectNumber`	`String`	The human readable project identifier
`organizationId`	`String`	The internal ID of the organization this project belongs to
`name`	`String`	The name of the project
`inactive`	`Boolean`	Whether project is inactive or active
`description`	`String`	The description of the project
`location`	`String`	The location of the project
`projectGroup`	`Object`	An optional Project Group object
`projectGroup.id`	`String`	The internal ID of the project group (region/business unit)
`projectGroup.organizationId`	`String`	The internal ID of the organization this project group belongs to
`projectGroup.name`	`String`	The name of the project group
`projectGroup.description`	`String`	The description of the project group

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 421

{
  "id" : "4e6ba887-a925-4730-aa84-0c688a708160",
  "externalProjectId" : "EXT_P1",
  "organizationId" : "26032ced-fec9-4d6e-b9c7-4d99f1a61113",
  "name" : "P1",
  "inactive" : false,
  "projectType" : "COMMERCIAL",
  "projectGroup" : {
    "id" : "2e9eba2a-88d6-4331-989f-6be8dd9c6b2e",
    "organizationId" : "26032ced-fec9-4d6e-b9c7-4d99f1a61113",
    "name" : "Group 1",
    "description" : "Group description"
  }
}

Set Project Status API

Set Project Status API is used to set 'active' or 'inactive' status for an existing project from Newmetrix.
The client executing request must provide either projectExternalId or internal project id as the value of the path variable {projectId} depending on the value of useExternalId parameter.
User calling this API must have permission to access the organization to which the project belongs to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If project cannot be found the response code 404 is returned.

request

PATCH /api/v1/organization/118830fd-d6e1-40ce-9a0d-5369f155c10d/project/EXT_P1/activation/status/true?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 35. /api/v1/organization/{organizationId}/project/{projectId}/activation/status/{isInactive}
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the useExternalId parameter
`isInactive`	Set 'Inactive' or 'Active' status of the project depending on the isInactive parameter

Table 36. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

sample response

HTTP/1.1 200 OK

Get Projects API

Get Projects API is used to get the organization’s projects from Newmetrix.
The returned list of projects is always sorted by name in the alphabetical order. User calling this API must have permission to access the organization to which the projects belong to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.

request

GET /api/v1/organization/442fe606-16fe-403e-b86f-d4197168dfe9/project?page=0&perPage=11&includeInactive=true HTTP/1.1
Host: api-public.smartvid.io

Table 37. /api/v1/organization/{organizationId}/project
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to

Table 38. request parameters
Parameter	Description
`page`	The zero based page number of the result set
`perPage`	The number of projects per page (max. 1000)
`includeInactive`	By default, 'includeInactive' = false. If set to true, return all objects including inactive ones. If set to false, only return the active ones, do not return inactive projects

Table 39. response fields description
Path	Type	Description
`projects[]projectType`	`String`	Type of the project. Can have one of the following values ASSET_REMOVAL
`projects[]startDate`	`String`	Start date of the project
`projects[]endDate`	`String`	End date of the project
`projects[]longitude`	`Number`	Longitude of the project
`projects[]latitude`	`Number`	Latitude of the project
`projects[]budget`	`Number`	Project’s budget ($)
`projects[]addressLine1`	`String`	Project’s address
`projects[]city`	`String`	Project’s city
`projects[]postalCode`	`String`	Project’s postal code
`projects[]state`	`String`	Project’s state
`projects[]country`	`String`	Project’s country
`projects[].id`	`String`	The internal ID of the project
`projects[].externalProjectId`	`String`	The ID of the project in the external system
`projects[].projectNumber`	`String`	The human readable project identifier
`projects[].organizationId`	`String`	The internal ID of the organization this project belongs to
`projects[].name`	`String`	The name of the project
`projects[].description`	`String`	The description of the project
`projects[].location`	`String`	The location of the project
`projects[].projectGroupId`	`String`	The internal ID of the project group (region/business unit)
`projects[].inactive`	`Boolean`	Whether project is inactive or active

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 792

{
  "projects" : [ {
    "id" : "f55c9f7b-bb27-424b-9906-49ae03e9878a",
    "projectNumber" : "P12345",
    "externalProjectId" : "12345",
    "organizationId" : "442fe606-16fe-403e-b86f-d4197168dfe9",
    "name" : "P1",
    "description" : "Project description",
    "location" : "Project location",
    "projectGroupId" : "427a371f-477a-4aa3-a45a-39d9be419b79",
    "inactive" : false
  }, {
    "id" : "b2feb735-7b28-4e85-b2ec-a11c4ade028f",
    "externalProjectId" : "EXT_P1",
    "organizationId" : "442fe606-16fe-403e-b86f-d4197168dfe9",
    "name" : "P2",
    "inactive" : false
  }, {
    "id" : "aa9002a5-675f-4fb2-93bf-737c42692654",
    "externalProjectId" : "EXT_P1",
    "organizationId" : "442fe606-16fe-403e-b86f-d4197168dfe9",
    "name" : "P3",
    "inactive" : false
  } ]
}

Delete Project API

Delete Project API is used to delete an existing project from Newmetrix.
This API deletes project and all project related data (e.g. assets, observations, etc.).
The project is deleted based on the projectExternalId or id depending on the value of the useExternalId parameter.
User calling this API must have permission to manage projects in the organization to which the project belongs to.
Upon successful execution the API returns 204 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
Client calling this API will not receive an error if the project specified by the ID cannot be not found, the response code 204 is returned in this case instead.

request

DELETE /api/v1/organization/16d666c5-f3f9-4444-9a5f-8a4f20c71bf9/project/EXT_P1?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 40. /api/v1/organization/{organizationId}/project/{projectId}
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 41. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

sample response

HTTP/1.1 204 No Content

Trade Partners

Sync Trade Partners API

Sync Trade Partners API is used to create new or update existing trade partners in Newmetrix.
The organizationId path parameter must match to all of the organizationId’s in the payload, this means that user can sync only the trade partners from a single organization in a single call to this API.
This API allows users to optionally set tradePartnerExternalId’s for each trade partner as another form of identification. Each tradePartnerExternalId must be unique (unless empty) across the organization.
The system will try to locate existing trade partners based on the tradePartnerExternalId or id depending on the value of the useExternalId parameter.
For existing trade partners the following fields cannot be updated: id, organizationId and externalTradePartnerId.
The API is limited to work with 100 trade partners at a time.
User calling this API must have permission to create and update trade partners for the organization specified.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.

request

POST /api/v1/organization/a93d3c2c-8baa-40f6-9df1-7bd90099f291/tradepartner/sync?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 829

{
  "tradePartners" : [ {
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_1",
    "name" : "TP1 Updated",
    "description" : "TP1 Descr Updated",
    "trade" : "TP1 Trade Updated",
    "telephone" : "111-111-1111",
    "email" : "tp1@examples.com",
    "fieldsToClear" : [ ]
  }, {
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_2",
    "name" : "TP2",
    "description" : "TP2 Descr",
    "trade" : "TP2 Trade Updated",
    "email" : "tp2@examples.com",
    "fieldsToClear" : [ ]
  }, {
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_3",
    "name" : "TP3 new",
    "description" : "TP3 descr_new",
    "trade" : "TP3 trade new",
    "fieldsToClear" : [ ]
  } ]
}

Table 42. /api/v1/organization/{organizationId}/tradepartner/sync
Parameter	Description
`organizationId`	The internal ID of the organization the trade partners belong to

Table 43. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

Table 44. request body
Path	Type	Description
`tradePartners[].id`	`String`	The internal ID of the trade partner
`tradePartners[].externalTradePartnerId`	`String`	The ID of the trade partner in the external system. Must be unique across organization or left empty.
`tradePartners[].organizationId`	`String`	The internal ID of the organization this trade partner is associated with. This is a required field.
`tradePartners[].name`	`String`	The name of the trade partner
`tradePartners[].description`	`String`	The description of the trade partner
`tradePartners[].email`	`String`	The e-mail address of the trade partner
`tradePartners[].trade`	`String`	The trade of the trade partner
`tradePartners[].addressLine1`	`String`	The first line of the trade partner’s address
`tradePartners[].addressLine2`	`String`	The second line of the trade partner’s address
`tradePartners[].city`	`String`	The city of the trade partner’s address
`tradePartners[].postalCode`	`String`	The postal code of the trade partner’s address
`tradePartners[].state`	`String`	The state of the trade partner’s address
`tradePartners[].country`	`String`	The country of the trade partner’s address
`tradePartners[].telephone`	`String`	The phone of the trade partner
`tradePartners[].companyWebsite`	`String`	The company website of the trade partner
`tradePartners[].taxId`	`String`	The tax ID of the trade partner
`tradePartners[].isActive`	`Boolean`	The indicator if the given trade partner is active or not
`tradePartners[].fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "trade", "city", "description", "addressLine1", "addressLine2", "telephone", "companyWebsite", "country", "state", "postalCode", "taxId", "isActive", "email"

Table 45. response fields description
Path	Type	Description
`tradePartners[].id`	`String`	The internal ID of the trade partner
`tradePartners[].externalTradePartnerId`	`String`	The ID of the trade partner in the external system
`tradePartners[].organizationId`	`String`	The internal ID of the organization this trade partner is associated with
`tradePartners[].name`	`String`	The name of the trade partner
`tradePartners[].description`	`String`	The description of the trade partner
`tradePartners[].email`	`String`	The e-mail address of the trade partner
`tradePartners[].trade`	`String`	The trade of the trade partner
`tradePartners[].addressLine1`	`String`	The first line of the trade partner’s address
`tradePartners[].addressLine2`	`String`	The second line of the trade partner’s address
`tradePartners[].city`	`String`	The city of the trade partner’s address
`tradePartners[].postalCode`	`String`	The postal code of the trade partner’s address
`tradePartners[].state`	`String`	The state of the trade partner’s address
`tradePartners[].country`	`String`	The country of the trade partner’s address
`tradePartners[].telephone`	`String`	The phone of the trade partner
`tradePartners[].companyWebsite`	`String`	The company website of the trade partner
`tradePartners[].taxId`	`String`	The tax ID of the trade partner
`tradePartners[].isActive`	`Boolean`	The indicator if the given trade partner is active or not

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 970

{
  "tradePartners" : [ {
    "id" : "ee75cd97-58c7-42e0-bd19-462377de475d",
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_3",
    "name" : "TP3 new",
    "description" : "TP3 descr_new",
    "trade" : "TP3 trade new",
    "isActive" : true
  }, {
    "id" : "6adb0ab1-cb17-4654-84eb-ea2e6bcee5d4",
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_1",
    "name" : "TP1 Updated",
    "description" : "TP1 Descr Updated",
    "trade" : "TP1 Trade Updated",
    "telephone" : "111-111-1111",
    "isActive" : true,
    "email" : "tp1@examples.com"
  }, {
    "id" : "83f18707-cc3c-420b-a12e-c8274fa0d647",
    "organizationId" : "a93d3c2c-8baa-40f6-9df1-7bd90099f291",
    "externalTradePartnerId" : "EXT_ID_2",
    "name" : "TP2",
    "description" : "TP2 Descr",
    "trade" : "TP2 Trade Updated",
    "isActive" : true,
    "email" : "tp2@examples.com"
  } ]
}

Get Trade Partner API

Get Trade Partner API is used to get an existing trade partner from Newmetrix.
The trade partner is retrieved based on the tradePartnerExternalId or id depending on the value of the useExternalId parameter.
User calling this API must have permission to access the trade partners in the organization with which the trade partner is associated.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If trade partner cannot be found the response code 404 is returned.

request

GET /api/v1/organization/ea4a1be6-eda4-49ad-94f8-a4ad55872ba2/tradepartner/EXT_ID_1?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 46. /api/v1/organization/{organizationId}/tradepartner/{tradePartnerId}
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to
`tradePartnerId`	The ID of the trade partner either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 47. request parameters
Parameter	Description
`useExternalId`	When set to true, tradePartnerId is the ID of the trade partner in the external system

Table 48. response fields description
Path	Type	Description
`id`	`String`	The internal ID of the trade partner
`externalTradePartnerId`	`String`	The ID of the trade partner in the external system
`organizationId`	`String`	The internal ID of the organization this trade partner is associated with
`name`	`String`	The name of the trade partner
`description`	`String`	The description of the trade partner
`email`	`String`	The e-mail address of the trade partner
`trade`	`String`	The trade of the trade partner
`addressLine1`	`String`	The first line of the trade partner’s address
`addressLine2`	`String`	The second line of the trade partner’s address
`city`	`String`	The city of the trade partner’s address
`postalCode`	`String`	The postal code of the trade partner’s address
`state`	`String`	The state of the trade partner’s address
`country`	`String`	The country of the trade partner’s address
`telephone`	`String`	The phone of the trade partner
`companyWebsite`	`String`	The company website of the trade partner
`taxId`	`String`	The tax ID of the trade partner
`isActive`	`Boolean`	The indicator if the given trade partner is active or not

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 281

{
  "id" : "05d66829-2600-499f-b346-bf79ae847f98",
  "organizationId" : "ea4a1be6-eda4-49ad-94f8-a4ad55872ba2",
  "externalTradePartnerId" : "EXT_ID_1",
  "name" : "TP1",
  "description" : "TP1 Descr",
  "trade" : "TP1 Trade",
  "telephone" : "111-111-11111",
  "isActive" : true
}

Get Trade Partners for Organization API

Get Trade Partners for Organization API is used to obtain a paged list of trade partners for a given organization from Newmetrix.
It returns a sorted (by name) and paged list of trade partners where maximum page size cannot exceed 100 items.
User calling this API must have permission to access the trade partners in the organization with which the trade partners are associated.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.

request

GET /api/v1/organization/70d5875b-da10-46b1-a066-5b1ba9f557aa/tradepartner?offset=0&limit=100 HTTP/1.1
Host: api-public.smartvid.io

Table 49. /api/v1/organization/{organizationId}/tradepartner
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to

Table 50. request parameters
Parameter	Description
`offset`	Offset (in the number of items) for the returned result set
`limit`	Limit (in the number of items, max. 100) for the returned result set

Table 51. response fields description
Path	Type	Description
`tradePartners[].id`	`String`	The internal ID of the trade partner
`tradePartners[].externalTradePartnerId`	`String`	The ID of the trade partner in the external system
`tradePartners[].organizationId`	`String`	The internal ID of the organization this trade partner is associated with
`tradePartners[].name`	`String`	The name of the trade partner
`tradePartners[].description`	`String`	The description of the trade partner
`tradePartners[].email`	`String`	The e-mail address of the trade partner
`tradePartners[].trade`	`String`	The trade of the trade partner
`tradePartners[].addressLine1`	`String`	The first line of the trade partner’s address
`tradePartners[].addressLine2`	`String`	The second line of the trade partner’s address
`tradePartners[].city`	`String`	The city of the trade partner’s address
`tradePartners[].postalCode`	`String`	The postal code of the trade partner’s address
`tradePartners[].state`	`String`	The state of the trade partner’s address
`tradePartners[].country`	`String`	The country of the trade partner’s address
`tradePartners[].telephone`	`String`	The phone of the trade partner
`tradePartners[].companyWebsite`	`String`	The company website of the trade partner
`tradePartners[].taxId`	`String`	The tax ID of the trade partner
`tradePartners[].isActive`	`Boolean`	The indicator if the given trade partner is active or not

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 327

{
  "tradePartners" : [ {
    "id" : "3ac2027e-f609-4490-916b-3060f41dd786",
    "organizationId" : "70d5875b-da10-46b1-a066-5b1ba9f557aa",
    "externalTradePartnerId" : "EXT_ID_1",
    "name" : "TP1",
    "description" : "TP1 Descr",
    "trade" : "TP1 Trade",
    "telephone" : "111-111-11111",
    "isActive" : true
  } ]
}

Get Trade Partners for Project API

Get Trade Partners for Project API is used to obtain a paged list of trade partners for a given project from Newmetrix.
It returns a sorted (by name) and paged list of trade partners where maximum page size cannot exceed 100 items.
User calling this API must have permission to access the trade partners in the project of the organization with which the trade partners are associated.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.

request

GET /api/v1/organization/364ef662-d8f4-402f-938c-219bdcc69484/project/b12b992f-35e9-447d-aca2-c93ca3cfee65/tradepartner?offset=0&limit=100 HTTP/1.1
Host: api-public.smartvid.io

Table 52. /api/v1/organization/{organizationId}/project/{projectId}/tradepartner
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to
`projectId`	The internal ID of the project the trade partner belongs to

Table 53. request parameters
Parameter	Description
`offset`	Offset (in the number of items) for the returned result set
`limit`	Limit (in the number of items, max. 100) for the returned result set

Table 54. response fields description
Path	Type	Description
`tradePartners[].id`	`String`	The internal ID of the trade partner
`tradePartners[].externalTradePartnerId`	`String`	The ID of the trade partner in the external system
`tradePartners[].organizationId`	`String`	The internal ID of the organization this trade partner is associated with
`tradePartners[].name`	`String`	The name of the trade partner
`tradePartners[].description`	`String`	The description of the trade partner
`tradePartners[].email`	`String`	The e-mail address of the trade partner
`tradePartners[].trade`	`String`	The trade of the trade partner
`tradePartners[].addressLine1`	`String`	The first line of the trade partner’s address
`tradePartners[].addressLine2`	`String`	The second line of the trade partner’s address
`tradePartners[].city`	`String`	The city of the trade partner’s address
`tradePartners[].postalCode`	`String`	The postal code of the trade partner’s address
`tradePartners[].state`	`String`	The state of the trade partner’s address
`tradePartners[].country`	`String`	The country of the trade partner’s address
`tradePartners[].telephone`	`String`	The phone of the trade partner
`tradePartners[].companyWebsite`	`String`	The company website of the trade partner
`tradePartners[].taxId`	`String`	The tax ID of the trade partner
`tradePartners[].isActive`	`Boolean`	The indicator if the given trade partner is active or not

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 327

{
  "tradePartners" : [ {
    "id" : "22c4376e-1063-425e-995c-6d6fa04a7590",
    "organizationId" : "364ef662-d8f4-402f-938c-219bdcc69484",
    "externalTradePartnerId" : "EXT_ID_1",
    "name" : "TP1",
    "description" : "TP1 Descr",
    "trade" : "TP1 Trade",
    "telephone" : "111-111-11111",
    "isActive" : true
  } ]
}

Delete Trade Partner API

Delete Trade Partner API is used to delete an existing trade partner from Newmetrix.
The trade partner is deleted based on the tradePartnerExternalId or id depending on the value of the useExternalId parameter.
User calling this API must have permission to delete trade partners in the organization with which the trade partner is associated.
Upon successful execution the API returns 204 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
Client calling this API will not receive an error if the trade partner specified by the ID cannot be not found, the response code 204 is returned in this case instead.

request

DELETE /api/v1/organization/6926a8c1-54c3-4643-80b0-fb74d82477d8/tradepartner/EXT_ID_1?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 55. /api/v1/organization/{organizationId}/tradepartner/{tradePartnerId}
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to
`tradePartnerId`	The ID of the trade partner either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 56. request parameters
Parameter	Description
`useExternalId`	When set to true, tradePartnerId is the ID of the trade partner in the external system

sample response

HTTP/1.1 204 No Content

Assign Trade Partners to Project API

Assign Trade Partners to Project API is used to assign maltiple trade partners specified by their IDs to an existing project in Newmetrix.
The trade partners' IDs are either internal Newmetrix IDs or external trade partners IDs based on the useExternalId parameter.
User calling this API must have permission to assign trade partners to the project in the organization with which the trade partner is associated.
Upon successful execution the API returns 201 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If trade partner or the project cannot be found the response code 404 is returned.

request

PUT /api/v1/organization/d9fd4005-1ca2-418b-9d32-9aed9d29f2a3/project/EXT_PROJ_ID_1/tradepartner?useExternalId=true HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: api-public.smartvid.io
Content-Length: 52

{
  "tradePartnerIds" : [ "EXT_ID_1", "EXT_ID_2" ]
}

Table 57. /api/v1/organization/{organizationId}/project/{projectId}/tradepartner
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to
`projectId`	The ID of the project, either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 58. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId is the ID of the project in the external system

sample response

HTTP/1.1 201 Created

Remove Trade Partner from Project API

Remove Trade Partner from Project API is used to remove a trade partner specified by ID from an existing project in Newmetrix.
The trade partner’s ID is either internal Newmetrix ID or external trade partner’s ID based on the useExternalId parameter.
User calling this API must have permission to remove trade partners from the project in the organization with which the trade partner is associated.
Upon successful execution the API returns 201 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If trade partner or the project cannot be found the response code 404 is returned.

request

DELETE /api/v1/organization/a523b942-f4fc-42cb-ace5-51b3f1be1f31/project/EXT_PROJ_ID_1/tradepartner/EXT_ID_1?useExternalId=true HTTP/1.1
Host: api-public.smartvid.io

Table 59. /api/v1/organization/{organizationId}/project/{projectId}/tradepartner/{tradePartnerId}
Parameter	Description
`organizationId`	The internal ID of the organization the trade partner belongs to
`projectId`	The ID of the project, either in Smartvid or in the external system, depending on the value of the useExternalId parameter
`tradePartnerId`	The ID of the trade partner either in Smartvid or in the external system, depending on the value of the useExternalId parameter

Table 60. request parameters
Parameter	Description
`useExternalId`	When set to true, projectId and tradePartnerId are the IDs of the project and trade partner in the external system

sample response

HTTP/1.1 204 No Content

Update Trade partner’s external ID API

Update Trade partner’s external ID API is used to update an external ID of an existing trade partner in Newmetrix.
User calling this API must have permission to manage projects and access trade partners in the organization to which the project belongs to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed or in case where the trade partner with a given external ID already exists in the given organization the response code 400 is returned.
To set an external ID for the trade partner that doesn’t have one, omit the oldId field in the request payload.
For any permission related errors the response code 401 is returned.
If trade partner’s cannot be found the response code 404 is returned.

request

PATCH /api/v1/organization/8bebb98c-41f9-4df7-9d98-7098163617db/project/02aed286-ee92-4b3b-a6c2-786af631d699/tradepartner/05efe15b-cc0b-4966-a798-e15625ba23ec/externalId HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 53

{
  "oldId" : "EXT_ID_1",
  "newId" : "EXT_UPD_TP1"
}

Table 61. /api/v1/organization/{organizationId}/project/{internalProjectId}/tradepartner/{tradePartnerId}/externalId
Parameter	Description
`organizationId`	The internal ID of the organization the projects belong to
`internalProjectId`	The internal ID of the project for which an external ID needs to be updated
`tradePartnerId`	The trade partner ID for which an external ID needs to be updated

Table 62. request body
Path	Type	Description
`oldId`	`String`	The old external ID (optional) of an existing trade partner
`newId`	`String`	The new external ID for an existing trade partner

Table 63. response fields description
Path	Type	Description
`id`	`String`	The internal ID of the trade partner
`externalTradePartnerId`	`String`	The ID of the trade partner in the external system
`organizationId`	`String`	The internal ID of the organization this trade partner is associated with
`name`	`String`	The name of the trade partner
`description`	`String`	The description of the trade partner
`email`	`String`	The e-mail address of the trade partner
`trade`	`String`	The trade of the trade partner
`addressLine1`	`String`	The first line of the trade partner’s address
`addressLine2`	`String`	The second line of the trade partner’s address
`city`	`String`	The city of the trade partner’s address
`postalCode`	`String`	The postal code of the trade partner’s address
`state`	`String`	The state of the trade partner’s address
`country`	`String`	The country of the trade partner’s address
`telephone`	`String`	The phone of the trade partner
`companyWebsite`	`String`	The company website of the trade partner
`taxId`	`String`	The tax ID of the trade partner
`isActive`	`Boolean`	The indicator if the given trade partner is active or not

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 284

{
  "id" : "05efe15b-cc0b-4966-a798-e15625ba23ec",
  "organizationId" : "8bebb98c-41f9-4df7-9d98-7098163617db",
  "externalTradePartnerId" : "EXT_UPD_TP1",
  "name" : "TP1",
  "description" : "TP1 Descr",
  "trade" : "TP1 Trade",
  "telephone" : "111-111-11111",
  "isActive" : true
}

Users and project members

Invite Users To Project Group API

Invite Users To Project Group API can be used to invite new or existing users to a project group.

request

POST /api/v1/organization/e065ebbc-09fb-4981-977a-d9a8b2de24d5/projectgroup/d37ee424-e488-4bf4-9ae7-d329103b5aac/invitation HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 608

{
  "users" : [ {
    "email" : "joe@smartvid.io",
    "externalUserId" : "EXT_U1",
    "isSso" : true,
    "firstName" : "fn",
    "lastName" : "ln",
    "roles" : [ {
      "roleName" : "ADMIN",
      "moduleType" : "ASSETS"
    }, {
      "roleName" : "REGIONAL_SAFETY_ADMIN",
      "moduleType" : "OBSERVATIONS"
    }, {
      "roleName" : "REGIONAL_TRADE_PARTNER_ADMIN",
      "moduleType" : "TRADE_PARTNERS"
    } ],
    "fieldsToClear" : [ ]
  }, {
    "email" : "jane@smartvid.io",
    "roles" : [ {
      "roleName" : "ADMIN",
      "moduleType" : "ASSETS"
    } ],
    "fieldsToClear" : [ ]
  } ]
}

Table 64. /api/v1/organization/{organizationId}/projectgroup/{projectGroupId}/invitation
Parameter	Description
`organizationId`	The internal ID of the organization
`projectGroupId`	ID of the project group

Table 65. request body
Path	Type	Description
`users[].email`	`String`	Email of user to invite
`users[].externalUserId`	`String`	Sets external ID of the user
`users[].isSso`	`Boolean`	Sets if user is a single sign-on user. When set to true, user will automatically be set to active user status. If set to false and applied to an existing user previously set to true, the flag will be set and the user will be returned to an invited status
`users[].firstName`	`String`	Sets first name or user
`users[].lastName`	`String`	Sets last name of user
`users[].fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "firstName", "lastName"
`users[].roles[].roleName`	`String`	Can have one of the following values for ASSETS NON_MEMBER,USER,REGION_VIEWER,ADMIN. Can have one of the following values for OBSERVATIONS NON_MEMBER,USER,REGIONAL_SAFETY_ADMIN. Can have one of the following values for TRADE_PARTNERS NON_MEMBER,USER,REGIONAL_TRADE_PARTNER_ADMIN.
`users[].roles[].moduleType`	`String`	Module user is to be invited to. Can have one of the following values ASSETS,OBSERVATIONS,TRADE_PARTNERS,ANALYTICS

sample response

HTTP/1.1 201 Created

Invite Users To Project API

Invite Users To Project API can be used to invite new or existing users to a project.

request

POST /api/v1/organization/fa2ecbee-cdf0-4c90-8a66-cc0b35890d5d/project/EXT_P1/member/invitation?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 597

{
  "users" : [ {
    "email" : "joe@smartvid.io",
    "externalUserId" : "EXT_U1",
    "isSso" : true,
    "firstName" : "fn",
    "lastName" : "ln",
    "roles" : [ {
      "roleName" : "COLLABORATOR",
      "moduleType" : "ASSETS"
    }, {
      "roleName" : "SAFETY_COLLABORATOR",
      "moduleType" : "OBSERVATIONS"
    }, {
      "roleName" : "VIEWER",
      "moduleType" : "TRADE_PARTNERS"
    } ],
    "fieldsToClear" : [ ]
  }, {
    "email" : "jane@smartvid.io",
    "roles" : [ {
      "roleName" : "CONTRIBUTOR",
      "moduleType" : "ASSETS"
    } ],
    "fieldsToClear" : [ ]
  } ]
}

Table 66. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/member/invitation
Parameter	Description
`organizationId`	The internal ID of the organization
`projectOrExternalProjectId`	ID of project

Table 67. request parameters
Parameter	Description
`useExternalId`	When set to true, projectOrExternalProjectId will expect and external ID
`preventEmailSending`	Prevents project invite emails from being sent to users when set to true. Defaults to false

Table 68. request body
Path	Type	Description
`users[].email`	`String`	Email of user to invite
`users[].externalUserId`	`String`	Sets external ID of the user
`users[].isSso`	`Boolean`	Sets if user is a single sign-on user. When set to true, user will automatically be set to active user status. If set to false and applied to an existing user previously set to true, the flag will be set and the user will be returned to an invited status
`users[].firstName`	`String`	Sets first name or user
`users[].lastName`	`String`	Sets last name of user
`users[].fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "firstName", "lastName"
`users[].roles[].roleName`	`String`	Can have one of the following values for ASSETS NON_MEMBER,COLLABORATOR,RECEIVER,VIEWER,CONTRIBUTOR,OWNER. Can have one of the following values for OBSERVATIONS NON_MEMBER,SAFETY_ADMIN,SAFETY_COLLABORATOR,SAFETY_USER,SAFETY_OBSERVER. Can have one of the following values for TRADE_PARTNERS NON_MEMBER,VIEWER,TRADE_PARTNER_ADMIN.
`users[].roles[].moduleType`	`String`	Module user is to be invited to. Can have one of the following values ASSETS,OBSERVATIONS,TRADE_PARTNERS,ANALYTICS

sample response

HTTP/1.1 201 Created

Invite Users To Organization API

Invite Users To Organization API can be used to invite new or existing users to an organization.

request

POST /api/v1/organization/EXT_O1/member/invitation?useExternalId=true HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 628

{
  "users" : [ {
    "email" : "joe@smartvid.io",
    "externalUserId" : "EXT_U1",
    "isSso" : true,
    "firstName" : "fn",
    "lastName" : "ln",
    "roles" : [ {
      "roleName" : "ORGANIZATION_ADMIN",
      "moduleType" : "ASSETS"
    }, {
      "roleName" : "ORGANIZATION_SAFETY_ADMIN",
      "moduleType" : "OBSERVATIONS"
    }, {
      "roleName" : "ORGANIZATION_TRADE_PARTNER_ADMIN",
      "moduleType" : "TRADE_PARTNERS"
    } ],
    "fieldsToClear" : [ ]
  }, {
    "email" : "jane@smartvid.io",
    "roles" : [ {
      "roleName" : "USER",
      "moduleType" : "ASSETS"
    } ],
    "fieldsToClear" : [ ]
  } ]
}

Table 69. /api/v1/organization/{organizationOrExternalOrganizationId}/member/invitation
Parameter	Description
`organizationOrExternalOrganizationId`	ID of organization

Table 70. request parameters
Parameter	Description
`useExternalId`	When set to true, organizationOrExternalOrganizationId will expect an external ID
`preventEmailSending`	Prevents organization invite emails from being sent to users when set to true. Defaults to false

Table 71. request body
Path	Type	Description
`users[].email`	`String`	Email of user to invite
`users[].externalUserId`	`String`	Sets external ID of the user.
`users[].isSso`	`Boolean`	Sets if user is a single sign-on user. When set to true, user will automatically be set to active user status. If set to false and applied to an existing user previously set to true, the flag will be set and the user will be returned to an invited status
`users[].firstName`	`String`	Sets first name or user
`users[].lastName`	`String`	Sets last name of user
`users[].fieldsToClear[]`	`Array`	The list of fields that need to be cleared (set to null). The allowed values are: "firstName", "lastName"
`users[].roles[].roleName`	`String`	Can have one of the following values for ASSETS NO_ACCESS,ORGANIZATION_VIEWER,GUEST,USER,ORGANIZATION_ADMIN,PRIMARY_OWNER. Can have one of the following values for OBSERVATIONS NON_MEMBER,USER,ORGANIZATION_SAFETY_ADMIN. Can have one of the following values for TRADE_PARTNERS NON_MEMBER,USER,ORGANIZATION_TRADE_PARTNER_ADMIN.
`users[].roles[].moduleType`	`String`	Module user is to be invited to. Can have one of the following values ASSETS,OBSERVATIONS,TRADE_PARTNERS,ANALYTICS

sample response

HTTP/1.1 201 Created

Uninvite Users From Project Group API

Uninvite Users From Project Group API can be used to revoke a project group users membership.

request

DELETE /api/v1/organization/96518518-2314-45b4-ac92-a587712c283a/projectgroup/bc84bbdd-e10d-4e56-a76b-a6feaab16031/invitation/email@example.com HTTP/1.1
Host: public-api.smartvid.io

Table 72. /api/v1/organization/{organizationId}/projectgroup/{projectGroupId}/invitation/{userEmail}
Parameter	Description
`organizationId`	The internal ID of the organization
`projectGroupId`	ID of the project group
`userEmail`	Email of user to uninvite

Table 73. request parameters
Parameter	Description

sample response

HTTP/1.1 204 No Content

Uninvite Users From Project API

Uninvite Users From Project API can be used to revoke a project users membership.

request

DELETE /api/v1/organization/888a96d3-644e-40fc-b7ac-5c4183402360/project/EXT_P1/member/invitation/email@example.com?useExternalId=true HTTP/1.1
Host: public-api.smartvid.io

Table 74. /api/v1/organization/{organizationId}/project/{projectOrExternalProjectId}/member/invitation/{userEmail}
Parameter	Description
`organizationId`	The internal ID of the organization
`projectOrExternalProjectId`	ID of project
`userEmail`	Email of user to uninvite

Table 75. request parameters
Parameter	Description
`useExternalId`	When set to true, projectOrExternalProjectId will expect an external ID
`preventEmailSending`	Prevents project un-invite emails from being sent to users when set to true. Defaults to false

sample response

HTTP/1.1 204 No Content

Uninvite Users From Organization API

Uninvite Users From Organization API can be used to revoke an organization users membership.

request

DELETE /api/v1/organization/EXT_O1/member/invitation/email@example.com?useExternalId=true HTTP/1.1
Host: public-api.smartvid.io

Table 76. /api/v1/organization/{organizationOrExternalOrganizationId}/member/invitation/{userEmail}
Parameter	Description
`organizationOrExternalOrganizationId`	ID of organization
`userEmail`	Email of user to uninvite

Table 77. request parameters
Parameter	Description
`useExternalId`	When set to true, organizationOrExternalOrganizationId will expect an external ID
`preventEmailSending`	Prevents project un-invite emails from being sent to users when set to true. Defaults to false

sample response

HTTP/1.1 204 No Content

Get Organization Users API

Get the list of users for a given organization.

request

GET /api/v1/organization/3b1c32dc-2970-484b-9f81-2f5ac8883d21/user?page=0&perPage=1000 HTTP/1.1
Host: public-api.smartvid.io

Table 78. /api/v1/organization/{organizationId}/user
Parameter	Description
`organizationId`	Internal ID of the organization

Table 79. request parameters
Parameter	Description
`page`	Page
`perPage`	Number of users per page. This value cannot be greater than 1,000

Table 80. response fields description
Path	Type	Description
`users[].id`	`String`	Internal ID of the user
`users[].firstName`	`String`	First name
`users[].lastName`	`String`	Last name
`users[].email`	`String`	Email
`users[].externalUserId`	`String`	External ID of the user
`users[].isActive`	`Boolean`	The indicator if the given user is active
`users[].isInvited`	`Boolean`	The indicator if the given user is invited
`users[].isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 687

{
  "users" : [ {
    "id" : "1",
    "firstName" : "Admin",
    "lastName" : "Admin",
    "email" : "admin@smartvid.io",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : false
  }, {
    "id" : "f1bd5685-035f-418b-9c3e-221d6850e815",
    "firstName" : "fn",
    "lastName" : "ln",
    "email" : "email@example.com",
    "externalUserId" : "EXT_USER1",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : true
  }, {
    "id" : "36d2bec9-1424-4ad1-a030-80aca481af1b",
    "firstName" : "fn2",
    "lastName" : "ln2",
    "email" : "email2@example.com",
    "externalUserId" : "EXT_USER2",
    "isActive" : false,
    "isInvited" : false,
    "isSso" : true
  } ]
}

Get Project Users API

Get the list of users for a given project.

request

GET /api/v1/organization/768e0223-cba2-46cb-9ee3-bcfbbde6196a/project/458bca59-a228-4b08-be05-41d6e98a93ca/user?page=0&perPage=1000 HTTP/1.1
Host: public-api.smartvid.io

Table 81. /api/v1/organization/{organizationId}/project/{extOrIntProjectId}/user
Parameter	Description
`organizationId`	Internal ID of the organization
`extOrIntProjectId`	External or internal ID of the project

Table 82. request parameters
Parameter	Description
`useExternalId`	When set to true, extOrIntProjectId will expect an external ID
`page`	Page number
`perPage`	Number of users per page. This value cannot be greater than 1,000

Table 83. response fields description
Path	Type	Description
`projectUsers[].id`	`String`	Internal ID of the user
`projectUsers[].firstName`	`String`	First name
`projectUsers[].lastName`	`String`	Last name
`projectUsers[].email`	`String`	Email
`projectUsers[].externalUserId`	`String`	External ID of the user
`projectUsers[].isActive`	`Boolean`	The indicator if the given user is active
`projectUsers[].isInvited`	`Boolean`	The indicator if the given user is invited
`projectUsers[].isSso`	`Boolean`	Sets to true if user is a single sign-on user otherwise to false
`projectUsers[].assetsProjectRole`	`String`	Project role for the ASSETS module. Can have one of the following values NON_MEMBER, COLLABORATOR, RECEIVER, VIEWER, CONTRIBUTOR, OWNER
`projectUsers[].observationsProjectRole`	`String`	Project role for the OBSERVATIONS module. Can have one of the following values NON_MEMBER, SAFETY_ADMIN, SAFETY_COLLABORATOR, SAFETY_USER, SAFETY_OBSERVER
`projectUsers[].tradePartnersProjectRole`	`String`	Project role for the TRADE_PARTNERS module. Can have one of the following values NON_MEMBER, VIEWER, TRADE_PARTNER_ADMIN

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 408

{
  "projectUsers" : [ {
    "id" : "89b33cb3-4014-4179-b311-8b66353a8595",
    "firstName" : "fn",
    "lastName" : "ln",
    "email" : "email@example.com",
    "externalUserId" : "EXT_USER1",
    "isActive" : true,
    "isInvited" : false,
    "isSso" : true,
    "assetsProjectRole" : "COLLABORATOR",
    "observationsProjectRole" : "SAFETY_COLLABORATOR",
    "tradePartnersProjectRole" : "VIEWER"
  } ]
}

Update User’s external ID API

Update User’s external ID API is used to update an external ID of an existing user in Newmetrix.
User calling this API must have permission to manage at least one of organizations which the user belong to.
To set an external ID for the user that doesn’t have one, omit the oldId field in the request payload.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If user cannot be found the response code 404 is returned.

request

PATCH /api/v1/organization/13c20ba8-c28c-46df-ac4e-62b78abeb36a/user/email@example.com/externalId HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 64

{
  "oldId" : "OLD_EXTERNAL_ID",
  "newId" : "NEW_EXTERNAL_ID"
}

Table 84. /api/v1/organization/{organizationId}/user/{email:.+}/externalId
Parameter	Description
`organizationId`	The internal ID of the organization
`email`	User’s email

Table 85. request body
Path	Type	Description
`oldId`	`String`	The old external ID of an existing user - currently unused and can be omitted from request
`newId`	`String`	The new external ID of an existing user. NB: user’s external id should be unique

sample response

HTTP/1.1 200 OK

Reset User’s external ID API

Reset User’s external ID API is used to reset an external ID of an existing user in Newmetrix.
User calling this API must have permission to manage at least one of organizations which the user belong to.
Upon successful execution the API returns response payload along with 200 response code.
For any incorrect parameters passed the response code 400 is returned.
For any permission related errors the response code 401 is returned.
If user cannot be found the response code 404 is returned.

request

DELETE /api/v1/organization/0d9e94a9-03fb-42d1-a1fe-4ad39630c0fd/user/email@example.com/externalId HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io

Table 86. /api/v1/organization/{organizationId}/user/{email:.+}/externalId
Parameter	Description
`organizationId`	The internal ID of the organization
`email`	User’s email

sample response

HTTP/1.1 200 OK

Get User settings API

Get User Settings

request

GET /api/v1/organization/2bf27218-e6ca-48ad-8271-db9e241e59eb/user/email@example.com/settings HTTP/1.1
Host: public-api.smartvid.io

Table 87. /api/v1/organization/{organizationId}/user/{email}/settings
Parameter	Description
`organizationId`	The internal ID of the organization
`email`	User’s email

Table 88. response fields description
Path	Type	Description
`defaultHomePage`	`String`	Default Home Page (ASSETS, OBSERVATIONS or ANALYTICS currently)

sample response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 34

{
  "defaultHomePage" : "ASSETS"
}

Update User settings API

Update user settings

request

POST /api/v1/user/email@example.com/settings HTTP/1.1
Content-Type: application/json
Host: public-api.smartvid.io
Content-Length: 93

{
  "defaultHomePage" : "ASSETS",
  "primaryOrgId" : "915a7af6-8f4d-4f58-8b21-15c13339d689"
}

Table 89. /api/v1/user/{email}/settings
Parameter	Description
`email`	User’s email

Table 90. request body
Path	Type	Description
`defaultHomePage`	`String`	Default Home Page (ASSETS, OBSERVATIONS or ANALYTICS currently)
`primaryOrgId`	`String`	Primary Organization Id

sample response

HTTP/1.1 200 OK

Organizations and Project Groups

Retrieve project groups for an organization

Get the list of project groups for a given organization.

request

GET /api/v1/organization/786c0b76-890e-4f78-b518-13d675c8f44d/projectgroup HTTP/1.1
Host: api-public.smartvid.io

Table 91. /api/v1/organization/{organizationId}/projectgroup
Parameter	Description
`organizationId`	The internal ID of the organization projects groups belong to

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 587

{
  "projectGroups" : [ {
    "id" : "0d3774e7-d4e3-4684-8b2c-92cd71cb84e4",
    "organizationId" : "786c0b76-890e-4f78-b518-13d675c8f44d",
    "name" : "Group 2",
    "description" : "Group 2 description"
  }, {
    "id" : "84aacda1-2383-455e-826f-636ed79070c9",
    "organizationId" : "786c0b76-890e-4f78-b518-13d675c8f44d",
    "name" : "Group 1",
    "description" : "Group 1 description"
  }, {
    "id" : "6e37eb35-72d2-40d6-967f-5e80e8e97b84",
    "organizationId" : "786c0b76-890e-4f78-b518-13d675c8f44d",
    "name" : "Group 0",
    "description" : "Group 0 description"
  } ]
}

Retrieve organizations for the current user

Get the list of all organizations that the current user belongs to.

request

GET /api/v1/organization HTTP/1.1
Host: api-public.smartvid.io

Table 92. /api/v1/organization
Parameter	Description

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 537

{
  "organizations" : [ {
    "id" : "79bb63fb-34a0-6e8b-f968-ac0d79b2ef8c",
    "name" : "Smith Alice's Org"
  }, {
    "id" : "bc34e527-28b8-4bc7-9923-7c7a968fabbb",
    "name" : "Organization oQfxgMtGSZ",
    "description" : "Test organization 0"
  }, {
    "id" : "929d2743-acb8-4076-9ab5-f5271496fdb9",
    "name" : "Organization cPTTaNESHM",
    "description" : "Test organization 1"
  }, {
    "id" : "4cc8a976-e3b1-43d9-a39c-f30f25b55286",
    "name" : "Organization ZIXjhFnHjp",
    "description" : "Test organization 2"
  } ]
}

Integrations

Integration APIs are available to programmatically set up project-level integrations with 3rd parties. There are four APIs available: to create new integrations, update settings of existing integrations, get integration settings, and finally delete integrations. For each of the calls a project must be specified (using an internal ID or external ID) and an integrationType. Note: first integration must be set up manually in the User Interface to authenticate and establish an integration token for the user. Once that is done, API can be used to create subsequent integrations of that type. We recommend creating and using a designated service account for all integrations.

Get integration settings for project

Get integration settings for project, for the specified integrationType. If the project does not have the integration of the specified type set up, it returns 404 "Integration settings for projectID: projectId cannot be found"

Example request for all types of integration

request

GET /api/v1/organization/c2b40605-fcae-430b-9965-a0e7f8446bfa/project/4f267adb-59c5-4592-bd41-cef3a60a7fd6/integration/SHAREPOINT_SYNC/settings?useExternalId=false HTTP/1.1
Host: api-public.smartvid.io

Table 93. /api/v1/organization/{organizationId}/project/{projectId}/integration/{integrationType}/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter
`integrationType`	The type of the integration. Supports only SHAREPOINT_SYNC

Table 94. request body
Parameter	Description
`useExternalId`	If set to true, then the `projectId` parameter is expected to be an external identifier

Example response for Sharepoint

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 362

{
  "projectId" : "4f267adb-59c5-4592-bd41-cef3a60a7fd6",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "SHAREPOINT_SYNC",
  "settingsData" : {
    "partnerUserId" : "1",
    "folderId" : "folder1",
    "folderPath" : "root/folder/path",
    "historicalDataSyncDateRange" : "7_DAYS",
    "isForceReSyncAll" : false
  }
}

Table 95. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case SHAREPOINT_SYNC
`settingsData.partnerUserId`	`String`	An integration user id
`settingsData.isForceReSyncAll`	`Boolean`	Force resynchronization
`settingsData.folderId`	`String`	A destination folder id
`settingsData.folderPath`	`String`	A destination path of the folder
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL

Example response for Procore

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 563

{
  "projectId" : "d2eface1-7a13-495d-b9db-6ab87070f6eb",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "PROCORE_SYNC",
  "settingsData" : {
    "procoreCompanyId" : 1,
    "procoreCompanyName" : "Test Company",
    "procoreProjectId" : 1,
    "procoreProjectName" : "Test Project",
    "pushSettings" : "PUSH_FILES_AND_TAGS",
    "pullSettings" : "PULL_FILES",
    "albumSettings" : "EXISTING_ALBUM",
    "existingAlbumId" : 123,
    "existingAlbumName" : "Test Album",
    "historicalDataSyncDateRange" : "7_DAYS"
  }
}

Table 96. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case PROCORE_SYNC
`settingsData.procoreCompanyId`	`Number`	Company ID in Procore
`settingsData.procoreCompanyName`	`String`	Company name in Procore
`settingsData.procoreProjectId`	`Number`	Project ID in Procore
`settingsData.procoreProjectName`	`String`	Project name in Procore
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL
`settingsData.pullSettings`	`String`	Settings for downloading data from Procore. Can be one of the following values: PULL_FILES, PULL_FILES_AND_LOCATIONS
`settingsData.pushSettings`	`String`	Settings for upload data to Procore. Can be one of the following values: PUSH_NOTHING, PUSH_TAGS, PUSH_FILES_AND_TAGS
`settingsData.albumSettings`	`String`	Album handling strategy. Used if `pushSettings` value is `PUSH_FILES_AND_TAGSCan be one of the following values: SPECIFIED_ALBUM, EXISTING_ALBUM, WEEKLY_ALBUM
`settingsData.existingAlbumId`	`Number`	Album ID existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.existingAlbumName`	`String`	Album name existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.specifiedAlbumName`	`String`	The name of the album in Procore, which will be created in the absence. Used if `albumSettings` value is `SPECIFIED_ALBUM`
`settingsData.weeklyAlbumPrefix`	`String`	The weekly album prefix. Used if `albumSettings` value is `WEEKLY_ALBUM`

Example response for Struction Site

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 387

{
  "projectId" : "ace1875b-829b-435a-aa04-5927f4936a3c",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "STRUCTION_SITE_SYNC",
  "settingsData" : {
    "partnerUserId" : "1",
    "structionSiteProjectId" : "123",
    "structionSiteProjectName" : "str_name",
    "historicalDataSyncDepth" : "ALL",
    "downloadAssetsOption" : "IMAGES_ONLY"
  }
}

Table 97. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case STRUCTION_SITE_SYNC
`settingsData.structionSiteProjectId`	`String`	Struction site project id
`settingsData.structionSiteProjectName`	`String`	Struction site project name
`settingsData.historicalDataSyncDepth`	`String`	Can be of the following values: NONE, PAST_7, PAST_30, PAST_60, ALL
`settingsData.downloadAssetsOption`	`String`	Can be of the following values: IMAGES_ONLY, VIDEOWALKS_ONLY, VIDEOWALKS_AND_IMAGES
`settingsData.partnerUserId`	`String`	An integration user id

Get integration settings for user

Get integration settings across all projects for a given user in organization, for the specified integration type.

Example request for all types of integration

request

GET /api/v1/organization/7f957ff7-f614-4b9a-8744-ca27604af832/user/1/integration/PROCORE_SYNC/settings?useExternalUserId=false HTTP/1.1
Host: api-public.smartvid.io

Table 98. /api/v1/organization/{organizationId}/user/{userId}/integration/{integrationType}/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`userId`	The ID of the user either in Smartvid or in the external system, depending on the value of the `useExternalUserId` parameter
`integrationType`	The type of the integration. Can be one of the following values: PROCORE_SYNC,SHAREPOINT_SYNC,STRUCTION_SITE_SYNC,EGNYTE_SYNC,OXBLUE_SYNC,BOX_SYNC,ACONEX_SYNC,BIM360_FIELD_PHOTO_SYNC,FORGE_SYNC

Table 99. request body
Parameter	Description
`useExternalUserId`	If set to true, then the `useExternalUserId` parameter is expected to be an external identifier

Example response

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 166

[ {
  "projectId" : "a1acf261-e095-474b-9a23-128fedf7e734",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "PROCORE_SYNC"
} ]

Table 100. response body
Path	Type	Description
`[].userId`	`String`	Integration settings user id
`[].projectId`	`String`	Integration settings project id
`[].isEnabled`	`Boolean`	Is integration enabled
`[].isProcessing`	`Boolean`	Is integration currently processing
`[].integrationType`	`String`	Integration type

Create integration settings

Create integration settings for project is used to create a new integration of the specified integrationType. It accepts internal or external project IDs. Important Note: At least one integration must be set up manually in the User Interface to authenticate and establish an token for the user. Once that is done, this API call uses the token associated with the user making this call. If the token has not been established for the user it returns 401 UnAuthorized

Example for SharePoint

request

POST /api/v1/organization/043f2306-8263-4634-ba07-354479c1bb96/project/926b5bc9-d467-4e09-9abc-48d7ec37cb08/integration/SHAREPOINT_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 166

{
  "isEnabled" : true,
  "settingsData" : {
    "folderPath" : "root/folder/path",
    "historicalDataSyncDateRange" : "7_DAYS",
    "isForceReSyncAll" : false
  }
}

Table 101. /api/v1/organization/{organizationId}/project/{projectId}/integration/SHAREPOINT_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 102. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.isForceReSyncAll`	`Boolean`	Force resynchronization
`settingsData.folderPath`	`String`	A destination path of the folder
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL

sample response

HTTP/1.1 201 Created
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 335

{
  "projectId" : "926b5bc9-d467-4e09-9abc-48d7ec37cb08",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "SHAREPOINT_SYNC",
  "settingsData" : {
    "folderId" : "folder1",
    "folderPath" : "root/folder/path",
    "historicalDataSyncDateRange" : "7_DAYS",
    "isForceReSyncAll" : false
  }
}

Table 103. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case SHAREPOINT_SYNC
`settingsData.isForceReSyncAll`	`Boolean`	Force resynchronization
`settingsData.folderId`	`String`	A destination folder id
`settingsData.folderPath`	`String`	A destination path of the folder
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL

Example for Procore

request

POST /api/v1/organization/2b5ba7be-6b07-4d01-a139-30d90543f93a/project/ec7f8d98-40d7-449a-8cfc-af2e417f6f4d/integration/PROCORE_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 349

{
  "isEnabled" : true,
  "settingsData" : {
    "procoreCompanyName" : "Test Company",
    "procoreProjectName" : "Test Project",
    "pushSettings" : "PUSH_FILES_AND_TAGS",
    "pullSettings" : "PULL_FILES",
    "albumSettings" : "SPECIFIED_ALBUM",
    "specifiedAlbumName" : "Custom album name",
    "historicalDataSyncDateRange" : "7_DAYS"
  }
}

Table 104. /api/v1/organization/{organizationId}/project/{projectId}/integration/PROCORE_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 105. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.procoreCompanyId`	`Number`	Company ID in Procore
`settingsData.procoreCompanyName`	`String`	Company name in Procore. Is case sensitive. One of the `procoreCompanyId` or `procoreCompanyName` fields are required
`settingsData.procoreProjectId`	`Number`	Project id in Procore
`settingsData.procoreProjectName`	`String`	Project name in Procore. Is case sensitive. One of the `procoreProjectId` or `procoreProjectName` fields are required
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL
`settingsData.pullSettings`	`String`	Settings for downloading data from Procore. Is required. Can be one of the following values: PULL_FILES - download only files. PULL_FILES_AND_LOCATIONS - download files and locations
`settingsData.pushSettings`	`String`	Settings for uploading data to Procore. Is required. Can be one of the following values: PUSH_NOTHING - upload nothing. PUSH_FILES_AND_TAGS - upload all Smarvid.io files and tags. PUSH_TAGS - upload tags only
`settingsData.albumSettings`	`String`	Album handling strategy. Used if `pushSettings` value is `PUSH_FILES_AND_TAGSCan be one of the following values: SPECIFIED_ALBUM, EXISTING_ALBUM, WEEKLY_ALBUM. The default is WEEKLY_ALBUM
`settingsData.existingAlbumId`	`Number`	Album ID existing in Procore. Required if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.existingAlbumName`	`String`	Album name existing in Procore. Is case sensitive. Used if `albumSettings` value is `EXISTING_ALBUM`. Required if `existingAlbumId` is not specified
`settingsData.specifiedAlbumName`	`String`	The name of the album in Procore, which will be created in the absence. Used if `albumSettings` value is `SPECIFIED_ALBUM`. Default name is `Smartvid`
`settingsData.weeklyAlbumPrefix`	`String`	The weekly album prefix. Used if `albumSettings` value is `WEEKLY_ALBUM`. Default value is `Week of`

sample response

HTTP/1.1 201 Created
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 543

{
  "projectId" : "ec7f8d98-40d7-449a-8cfc-af2e417f6f4d",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "PROCORE_SYNC",
  "settingsData" : {
    "procoreCompanyId" : 1,
    "procoreCompanyName" : "Test Company",
    "procoreProjectId" : 1,
    "procoreProjectName" : "Test Project",
    "pushSettings" : "PUSH_FILES_AND_TAGS",
    "pullSettings" : "PULL_FILES",
    "albumSettings" : "SPECIFIED_ALBUM",
    "specifiedAlbumName" : "Custom album name",
    "historicalDataSyncDateRange" : "7_DAYS"
  }
}

Table 106. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case PROCORE_SYNC
`settingsData.procoreCompanyId`	`Number`	Company ID in Procore
`settingsData.procoreCompanyName`	`String`	Company name in Procore
`settingsData.procoreProjectId`	`Number`	Project ID in Procore
`settingsData.procoreProjectName`	`String`	Project name in Procore
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL
`settingsData.pullSettings`	`String`	Settings for downloading data from Procore. Can be one of the following values: PULL_FILES, PULL_FILES_AND_LOCATIONS
`settingsData.pushSettings`	`String`	Settings for upload data to Procore. Can be one of the following values: PUSH_NOTHING, PUSH_TAGS, PUSH_FILES_AND_TAGS
`settingsData.albumSettings`	`String`	Album handling strategy. Used if `pushSettings` value is `PUSH_FILES_AND_TAGSCan be one of the following values: SPECIFIED_ALBUM, EXISTING_ALBUM, WEEKLY_ALBUM
`settingsData.existingAlbumId`	`Number`	Album ID existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.existingAlbumName`	`String`	Album name existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.specifiedAlbumName`	`String`	The name of the album in Procore, which will be created in the absence. Used if `albumSettings` value is `SPECIFIED_ALBUM`
`settingsData.weeklyAlbumPrefix`	`String`	The weekly album prefix. Used if `albumSettings` value is `WEEKLY_ALBUM`

Example for Struction Site

request

POST /api/v1/organization/11ae9da4-c1cc-4e7c-9b2f-9f8a1a379713/project/90f9b774-6256-4769-ba0b-664f6201a9f2/integration/STRUCTION_SITE_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 173

{
  "isEnabled" : true,
  "settingsData" : {
    "historicalDataSyncDepth" : "PAST_7",
    "downloadAssetsOption" : "IMAGES_ONLY",
    "structionSiteProjectId" : "123"
  }
}

Table 107. /api/v1/organization/{organizationId}/project/{projectId}/integration/STRUCTION_SITE_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 108. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.historicalDataSyncDepth`	`String`	Can be of the following values: NONE, PAST_7, PAST_30, PAST_60, ALL
`settingsData.structionSiteProjectId`	`String`	Struction site project id
`settingsData.downloadAssetsOption`	`String`	Can be of the following values: IMAGES_ONLY, VIDEOWALKS_ONLY, VIDEOWALKS_AND_IMAGES

sample response

HTTP/1.1 201 Created
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 387

{
  "projectId" : "90f9b774-6256-4769-ba0b-664f6201a9f2",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "STRUCTION_SITE_SYNC",
  "settingsData" : {
    "partnerUserId" : "1",
    "structionSiteProjectId" : "123",
    "structionSiteProjectName" : "str_name",
    "historicalDataSyncDepth" : "ALL",
    "downloadAssetsOption" : "IMAGES_ONLY"
  }
}

Table 109. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case STRUCTION_SITE_SYNC
`settingsData.structionSiteProjectId`	`String`	Struction site project id
`settingsData.structionSiteProjectName`	`String`	Struction site project name
`settingsData.historicalDataSyncDepth`	`String`	A destination folder id
`settingsData.partnerUserId`	`String`	Partner user id
`settingsData.downloadAssetsOption`	`String`	Can be of the following values: IMAGES_ONLY, VIDEOWALKS_ONLY, VIDEOWALKS_AND_IMAGES

Update integration settings

This call is used to make changes to the settings of the existing integration. Note: you must first disable an integration to make changes to the parameters, and then re-enable the integration, once the desired changes have been made. If the integration is enabled no changes can happen except setting it to disabled.

Example for SharePoint

request

PUT /api/v1/organization/043f2306-8263-4634-ba07-354479c1bb96/project/926b5bc9-d467-4e09-9abc-48d7ec37cb08/integration/SHAREPOINT_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 167

{
  "isEnabled" : false,
  "settingsData" : {
    "folderPath" : "root/folder/path",
    "historicalDataSyncDateRange" : "7_DAYS",
    "isForceReSyncAll" : false
  }
}

Table 110. /api/v1/organization/{organizationId}/project/{projectId}/integration/SHAREPOINT_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 111. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.isForceReSyncAll`	`Boolean`	Force resynchronization
`settingsData.folderPath`	`String`	A destination path of the folder
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 336

{
  "projectId" : "926b5bc9-d467-4e09-9abc-48d7ec37cb08",
  "userId" : "1",
  "isEnabled" : false,
  "isProcessing" : false,
  "integrationType" : "SHAREPOINT_SYNC",
  "settingsData" : {
    "folderId" : "folder1",
    "folderPath" : "root/folder/path",
    "historicalDataSyncDateRange" : "7_DAYS",
    "isForceReSyncAll" : false
  }
}

Table 112. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case SHAREPOINT_SYNC
`settingsData.isForceReSyncAll`	`Boolean`	Force resynchronization
`settingsData.folderId`	`String`	A destination folder id
`settingsData.folderPath`	`String`	A destination path of the folder
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL

Example for Procore

request

PUT /api/v1/organization/2b5ba7be-6b07-4d01-a139-30d90543f93a/project/ec7f8d98-40d7-449a-8cfc-af2e417f6f4d/integration/PROCORE_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 300

{
  "isEnabled" : false,
  "settingsData" : {
    "procoreCompanyId" : 1,
    "procoreProjectId" : 1,
    "pushSettings" : "PUSH_FILES_AND_TAGS",
    "pullSettings" : "PULL_FILES",
    "albumSettings" : "EXISTING_ALBUM",
    "existingAlbumId" : 123,
    "historicalDataSyncDateRange" : "7_DAYS"
  }
}

Table 113. /api/v1/organization/{organizationId}/project/{projectId}/integration/PROCORE_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 114. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.procoreCompanyId`	`Number`	Company ID in Procore
`settingsData.procoreCompanyName`	`String`	Company name in Procore. Is case sensitive. One of the `procoreCompanyId` or `procoreCompanyName` fields are required
`settingsData.procoreProjectId`	`Number`	Project id in Procore
`settingsData.procoreProjectName`	`String`	Project name in Procore. Is case sensitive. One of the `procoreProjectId` or `procoreProjectName` fields are required
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL
`settingsData.pullSettings`	`String`	Settings for downloading data from Procore. Is required. Can be one of the following values: PULL_FILES - download only files. PULL_FILES_AND_LOCATIONS - download files and locations
`settingsData.pushSettings`	`String`	Settings for uploading data to Procore. Is required. Can be one of the following values: PUSH_NOTHING - upload nothing. PUSH_FILES_AND_TAGS - upload all Smarvid.io files and tags. PUSH_TAGS - upload tags only
`settingsData.albumSettings`	`String`	Album handling strategy. Used if `pushSettings` value is `PUSH_FILES_AND_TAGSCan be one of the following values: SPECIFIED_ALBUM, EXISTING_ALBUM, WEEKLY_ALBUM. The default is WEEKLY_ALBUM
`settingsData.existingAlbumId`	`Number`	Album ID existing in Procore. Required if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.existingAlbumName`	`String`	Album name existing in Procore. Is case sensitive. Used if `albumSettings` value is `EXISTING_ALBUM`. Required if `existingAlbumId` is not specified
`settingsData.specifiedAlbumName`	`String`	The name of the album in Procore, which will be created in the absence. Used if `albumSettings` value is `SPECIFIED_ALBUM`. Default name is `Smartvid`
`settingsData.weeklyAlbumPrefix`	`String`	The weekly album prefix. Used if `albumSettings` value is `WEEKLY_ALBUM`. Default value is `Week of`

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 544

{
  "projectId" : "ec7f8d98-40d7-449a-8cfc-af2e417f6f4d",
  "userId" : "1",
  "isEnabled" : false,
  "isProcessing" : false,
  "integrationType" : "PROCORE_SYNC",
  "settingsData" : {
    "procoreCompanyId" : 1,
    "procoreCompanyName" : "Test Company",
    "procoreProjectId" : 1,
    "procoreProjectName" : "Test Project",
    "pushSettings" : "PUSH_FILES_AND_TAGS",
    "pullSettings" : "PULL_FILES",
    "albumSettings" : "SPECIFIED_ALBUM",
    "specifiedAlbumName" : "Custom album name",
    "historicalDataSyncDateRange" : "7_DAYS"
  }
}

Table 115. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case PROCORE_SYNC
`settingsData.procoreCompanyId`	`Number`	Company ID in Procore
`settingsData.procoreCompanyName`	`String`	Company name in Procore
`settingsData.procoreProjectId`	`Number`	Project ID in Procore
`settingsData.procoreProjectName`	`String`	Project name in Procore
`settingsData.historicalDataSyncDateRange`	`String`	A date range after which all items will be synced. Can be one of the following values: NONE,7_DAYS,30_DAYS,60_DAYS,ALL
`settingsData.pullSettings`	`String`	Settings for downloading data from Procore. Can be one of the following values: PULL_FILES, PULL_FILES_AND_LOCATIONS
`settingsData.pushSettings`	`String`	Settings for upload data to Procore. Can be one of the following values: PUSH_NOTHING, PUSH_TAGS, PUSH_FILES_AND_TAGS
`settingsData.albumSettings`	`String`	Album handling strategy. Used if `pushSettings` value is `PUSH_FILES_AND_TAGSCan be one of the following values: SPECIFIED_ALBUM, EXISTING_ALBUM, WEEKLY_ALBUM
`settingsData.existingAlbumId`	`Number`	Album ID existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.existingAlbumName`	`String`	Album name existing in Procore. Used if `albumSettings` value is `EXISTING_ALBUM`
`settingsData.specifiedAlbumName`	`String`	The name of the album in Procore, which will be created in the absence. Used if `albumSettings` value is `SPECIFIED_ALBUM`
`settingsData.weeklyAlbumPrefix`	`String`	The weekly album prefix. Used if `albumSettings` value is `WEEKLY_ALBUM`

Example for Struction Site

request

PUT /api/v1/organization/11ae9da4-c1cc-4e7c-9b2f-9f8a1a379713/project/90f9b774-6256-4769-ba0b-664f6201a9f2/integration/STRUCTION_SITE_SYNC/settings?useExternalId=false HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 174

{
  "isEnabled" : false,
  "settingsData" : {
    "historicalDataSyncDepth" : "PAST_7",
    "downloadAssetsOption" : "IMAGES_ONLY",
    "structionSiteProjectId" : "123"
  }
}

Table 116. /api/v1/organization/{organizationId}/project/{projectId}/integration/STRUCTION_SITE_SYNC/settings
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter

Table 117. request body
Path	Type	Description
`isEnabled`	`Boolean`	Enable or disable current integration
`settingsData.historicalDataSyncDepth`	`String`	Can be of the following values: NONE, PAST_7, PAST_30, PAST_60, ALL
`settingsData.structionSiteProjectId`	`String`	Struction site project id
`settingsData.downloadAssetsOption`	`String`	Can be of the following values: IMAGES_ONLY, VIDEOWALKS_ONLY, VIDEOWALKS_AND_IMAGES

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 387

{
  "projectId" : "90f9b774-6256-4769-ba0b-664f6201a9f2",
  "userId" : "1",
  "isEnabled" : true,
  "isProcessing" : false,
  "integrationType" : "STRUCTION_SITE_SYNC",
  "settingsData" : {
    "partnerUserId" : "1",
    "structionSiteProjectId" : "123",
    "structionSiteProjectName" : "str_name",
    "historicalDataSyncDepth" : "ALL",
    "downloadAssetsOption" : "IMAGES_ONLY"
  }
}

Table 118. response body
Path	Type	Description
`userId`	`String`	The user ID who created integration
`projectId`	`String`	The project ID for a given integration
`isEnabled`	`Boolean`	Enabled/Disabled
`isProcessing`	`Boolean`	Currently is processing
`integrationType`	`String`	The type of the integration. In this case STRUCTION_SITE_SYNC
`settingsData.structionSiteProjectId`	`String`	Struction site project id
`settingsData.structionSiteProjectName`	`String`	Struction site project name
`settingsData.historicalDataSyncDepth`	`String`	A destination folder id
`settingsData.partnerUserId`	`String`	Partner user id
`settingsData.downloadAssetsOption`	`String`	Can be of the following values: IMAGES_ONLY, VIDEOWALKS_ONLY, VIDEOWALKS_AND_IMAGES

Delete integration settings

Use this call to delete an existing integration.

request

DELETE /api/v1/organization/d7957642-3286-4bee-8864-70a14e7e1764/project/848b93d2-2334-48e6-8d28-c3cb634260f7/integration/SHAREPOINT_SYNC/settings?useExternalId=false HTTP/1.1
Host: api-public.smartvid.io

Table 119. /api/v1/organization/{organizationId}/project/{projectId}/integration/{integrationType}/settings
Parameter	Description
`organizationId`	The internal ID of the organization the project belongs to
`projectId`	The ID of the project either in Smartvid or in the external system, depending on the value of the `useExternalId` parameter
`integrationType`	The type of the integration. Can be one of the following values: PROCORE_SYNC, SHAREPOINT_SYNC, STRUCTION_SITE_SYNC, EGNYTE_SYNC, OXBLUE_SYNC, BOX_SYNC, ACONEX_SYNC, BIM360_FIELD_PHOTO_SYNC, FORGE_SYNC

Table 120. request parameters
Parameter	Description
`useExternalId`	If set to true, then the `projectId` parameter is expected to be an external identifier

sample response

HTTP/1.1 204 No Content

Reporting

Schedule/run photo report for the project

Schedule photo report to be emailed to a set of users for photos with the defined set of tags. Multiple photo reports can be scheduled per project with various sets of users, tags and other settings.

Calling this API with reportFixedScheduleInterval set to NEVER will generate a one-time report instead of scheduling it to be generated periodically.

request

POST /api/v1/organization/4fa0e572-7208-4111-93f2-8f3e15b1dd27/project/c3feec02-7c2b-476e-839e-be6180ce6dd6/report/photo HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 546

{
  "isConstructionRelatedOnly" : true,
  "includedTags" : [ "PPE" ],
  "toUserEmails" : [ "admin@smartvid.io" ],
  "startDate" : "2024-04-10T10:08:46.940+0000",
  "endDate" : "2024-04-10T10:08:46.940+0000",
  "reportFixedScheduleInterval" : "DAILY",
  "photoReportSubType" : "DUAL_IMAGE",
  "recipeType" : "PDF",
  "tagConfidenceLevel" : "HIGH",
  "isIncludeAllTags" : false,
  "sortingType" : "PHOTO_DATE_LATEST_FIRST",
  "groupingType" : "TAGS_MOST_FIRST",
  "timeHours" : 0,
  "timeMinutes" : 0,
  "dayOfMonth" : 1,
  "dayOfWeek" : "MONDAY"
}

Table 121. /api/v1/organization/{organizationId}/project/{projectId}/report/photo
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	Internal ID of the project

Table 122. request body
Path	Type	Description
`isConstructionRelatedOnly`	`Boolean`	Only include photos tagged as 'construction'
`includedTags`	`Array`	Only include photos that are tagged with tags in this list
`toUserEmails`	`Array`	List of recipient emails to send the report to
`startDate`	`String`	Start date of the reporting interval
`endDate`	`String`	End date of the reporting interval
`reportFixedScheduleInterval`	`String`	Should contain one of the following values NEVER,HOURLY,DAILY,WEEKLY,MONTHLY
`photoReportSubType`	`String`	Should contain one of the following values SINGLE_IMAGE,DUAL_IMAGE
`recipeType`	`String`	Should contain one of the following values HTML,PDF
`tagConfidenceLevel`	`String`	Should contain one of the following values LOW,MEDIUM,HIGH
`isIncludeAllTags`	`Boolean`	Must include all specified tags
`description`	`String`	Text description for report
`sortingType`	`String`	Should contain one of the following values TAG_NAME_A_Z,TAG_NAME_Z_A,PHOTO_DATE_EARLIEST_FIRST,PHOTO_DATE_LATEST_FIRST
`groupingType`	`String`	Should contain one of the following values NONE,TAGS_FEWEST_FIRST,TAGS_MOST_FIRST,GROUPING_TAG_NAME_A_Z,GROUPING_TAG_NAME_Z_A
`timeHours`	`Number`	Should contain one of the following values from 1 to 24
`timeMinutes`	`Number`	Should contain one of the following values 0, 15, 30, 45
`dayOfMonth`	`Number`	Should contain one of the following values from 1 to 31
`dayOfWeek`	`String`	Should contain one of the following valuesMONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY

Schedule/run photo report for the project on behalf of a user

Only organization admins can call this API

request

POST /api/v1/organization/a9fe0651-c625-4758-a32a-e2c494043e46/project/5c6d19a0-f1b3-490e-8e1a-c422c45fb640/on_behalf_of_user/super_user/report/photo?useExternalUserId=true HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 546

{
  "isConstructionRelatedOnly" : true,
  "includedTags" : [ "PPE" ],
  "toUserEmails" : [ "admin@smartvid.io" ],
  "startDate" : "2024-04-10T10:08:44.863+0000",
  "endDate" : "2024-04-10T10:08:44.863+0000",
  "reportFixedScheduleInterval" : "DAILY",
  "photoReportSubType" : "DUAL_IMAGE",
  "recipeType" : "PDF",
  "tagConfidenceLevel" : "HIGH",
  "isIncludeAllTags" : false,
  "sortingType" : "PHOTO_DATE_LATEST_FIRST",
  "groupingType" : "TAGS_MOST_FIRST",
  "timeHours" : 0,
  "timeMinutes" : 0,
  "dayOfMonth" : 1,
  "dayOfWeek" : "MONDAY"
}

Table 123. /api/v1/organization/{organizationId}/project/{projectId}/on_behalf_of_user/{userId}/report/photo
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	Internal ID of the project
`userId`	Internal user ID who can run reports in this project

Table 124. request body
Path	Type	Description
`isConstructionRelatedOnly`	`Boolean`	Only include photos tagged as 'construction'
`includedTags`	`Array`	Only include photos that are tagged with tags in this list
`toUserEmails`	`Array`	List of recipient emails to send the report to
`startDate`	`String`	Start date of the reporting interval
`endDate`	`String`	End date of the reporting interval
`reportFixedScheduleInterval`	`String`	Should contain one of the following values NEVER,HOURLY,DAILY,WEEKLY,MONTHLY
`photoReportSubType`	`String`	Should contain one of the following values SINGLE_IMAGE,DUAL_IMAGE
`recipeType`	`String`	Should contain one of the following values HTML,PDF
`tagConfidenceLevel`	`String`	Should contain one of the following values LOW,MEDIUM,HIGH
`isIncludeAllTags`	`Boolean`	Must include all specified tags
`description`	`String`	Text description for report
`sortingType`	`String`	Should contain one of the following values TAG_NAME_A_Z,TAG_NAME_Z_A,PHOTO_DATE_EARLIEST_FIRST,PHOTO_DATE_LATEST_FIRST
`groupingType`	`String`	Should contain one of the following values NONE,TAGS_FEWEST_FIRST,TAGS_MOST_FIRST,GROUPING_TAG_NAME_A_Z,GROUPING_TAG_NAME_Z_A
`timeHours`	`Number`	Should contain one of the following values from 1 to 24
`timeMinutes`	`Number`	Should contain one of the following values 0, 15, 30, 45
`dayOfMonth`	`Number`	Should contain one of the following values from 1 to 31
`dayOfWeek`	`String`	Should contain one of the following valuesMONDAY,TUESDAY,WEDNESDAY,THURSDAY,FRIDAY,SATURDAY,SUNDAY

Get the list of scheduled photo reports for the project

Retrieve the list of scheduled photo reports and their settings for a given project.

request

GET /api/v1/organization/4fa0e572-7208-4111-93f2-8f3e15b1dd27/project/c3feec02-7c2b-476e-839e-be6180ce6dd6/report HTTP/1.1
Host: api-public.smartvid.io

Table 125. /api/v1/organization/{organizationId}/project/{projectId}/report
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	Internal ID of the project

Table 126. request body
Path	Type	Description
`photoReports[]`	`Array`
`photoReports[].id`	`String`	Internal ID of the scheduled report instance
`photoReports[].isConstructionRelatedOnly`	`Boolean`	Only include photos tagged as 'construction'
`photoReports[].includedTags`	`Array`	Only include photos that are tagged with tags in this list
`photoReports[].toUserEmails`	`Array`	List of recipient emails to send the report to
`photoReports[].startDate`	`String`	Start date of the reporting interval
`photoReports[].endDate`	`String`	End date of the reporting interval
`photoReports[].reportFixedScheduleInterval`	`String`	Photo report will be generated and emailed with the following periodicity
`photoReports[].photoReportSubType`	`String`	Layout of the photo report
`photoReports[].recipeType`	`String`	Generate HTML or PDF
`photoReports[].tagConfidenceLevel`	`String`	Only consider tags with the following confidence

sample response

HTTP/1.1 200 OK
Content-Type: application/problem+json;charset=UTF-8
Content-Length: 445

{
  "photoReports" : [ {
    "id" : "bd1a3b2d-42d6-4c32-9aef-efe31f80708c",
    "isConstructionRelatedOnly" : true,
    "includedTags" : [ "PPE" ],
    "toUserEmails" : [ "admin@smartvid.io" ],
    "startDate" : "2024-04-11T00:00:00.000+0000",
    "endDate" : "2024-04-11T00:00:00.000+0000",
    "reportFixedScheduleInterval" : "DAILY",
    "photoReportSubType" : "DUAL_IMAGE",
    "recipeType" : "PDF",
    "tagConfidenceLevel" : "HIGH"
  } ]
}

Remove scheduled photo report

Remove scheduled photo report for the project. This API only removes one scheduled photo report. Other scheduled photo reports are not changed.

request

DELETE /api/v1/organization/4fa0e572-7208-4111-93f2-8f3e15b1dd27/project/c3feec02-7c2b-476e-839e-be6180ce6dd6/report/photo/bd1a3b2d-42d6-4c32-9aef-efe31f80708c HTTP/1.1
Host: api-public.smartvid.io

Table 127. /api/v1/organization/{organizationId}/project/{projectId}/report/photo/{photoReportId}
Parameter	Description
`organizationId`	Internal ID of the organization
`projectId`	Internal ID of the project
`photoReportId`	Internal ID of the scheduled report instance. Can be obtained by calling /api/v1/organization/{organizationId}/project/{projectId}/report API

Metrics

The following metrics are currently available:

Table 128. List of supported metrics
Metric Name	Description
Activity Metrics
ASSET_UPLOAD_COUNT	Count of assets uploaded, by type
ASSET_CREATED_COUNT	Count of assets created, by type
AVG_UPLOAD_PER_DAY	Average number of uploads per day
TAG_INSTANCE_CREATION_COUNT	Number of tags created, by type
UPLOADER_USER_COUNT	Number of unique users who uploaded assets
ACTIVE_USER_COUNT	Number of active users
INTEGRATION_CREATED_COUNT	Number of assets created via integration(s), by content source type
USER_CREATED_COUNT	Number of assets created via direct uploads from WWW/mobile or public API, by content source type
INTEGRATION_UPLOADER_EXTERNAL_USER_COUNT	Count of unique integration system user ids who have uploaded assets through different sources of integrations per integration type
INTEGRATION_EXTERNAL_USER_ASSET_CREATED_COUNT	Count of assets created by integration system users
USER_ASSET_CREATED_COUNT	Count of assets created by users
USER_TAG_INSTANCE_CREATION_COUNT	Number of tags created by user, by type
USER_COMMENT_COUNT	Number of comments created by user
Safety Metrics
CONSTRUCTION_ASSET_COUNT	Count of assets with tag "Construction"
CONSTRUCTION_PHOTO_COUNT	Count of photos with tag "Construction"
CONSTRUCTION_TO_TOTAL_ASSET_RATIO	Count of Images with tag "Construction" / Total Assets
BULLDOZER_COUNT	Count of equipment type: bulldozer
PICKUP_TRUCK_COUNT	Count of equipment type: pickup truck
BOX_TRUCK_COUNT	Count of equipment type: box truck
FRONT_END_LOADER_COUNT	Count of equipment type: front end loader
BACKHOE_COUNT	Count of equipment type: backhoe
CONCRETE_MIXER_COUNT	Count of equipment type: concrete mixer
CONCRETE_PUMP_COUNT	Count of equipment type: concrete pump
DRILL_COUNT	Count of equipment type: drill
MOBILE_CRANE_COUNT	Count of equipment type: mobile crane
EXCAVATOR_COUNT	Count of equipment type: excavator
ALL_LADDERS_COUNT	Count of assets tagged with "Ladder", "Folding Ladder", "Extension Ladder", "Site Ladder", "Platform Ladder", "Access Platform"
LADDER_COUNT	Count of assets tagged with "Ladder"
FOLDING_LADDER_COUNT	Count of Folding Ladders
EXTENSION_LADDER_COUNT	Count of Extension Ladders
SITE_LADDER_COUNT	Count of Site Ladders
PLATFORM_LADDER_COUNT	Count of Platform Ladders
ACCESS_PLATFORM_COUNT	Count of Access Platforms
ALL_LIFTS_COUNT	Count of assets tagged with "Boom Lift", "Scissor Lift"
BOOM_LIFT_COUNT	Count of Boom lifts
SCISSOR_LIFT_COUNT	Count of Scissor lifts
SCAFFOLDING_COUNT	Count of Scaffolding
STAIRWAY_COUNT	Count of Stairway
EXPOSED_HOLE_COUNT	Count of Exposed hole
SOCIAL_DISTANCE_COMPLIANCE	Social Distance compliance
WAH_PER_HUNDRED_CONSTRUCTION	Count of Work at Height per 100 construction photos
LADDER_TO_LIFT_RATIO	Ladder-to-Lift Ratio
HOUSEKEEPING_AND_STANDING_WATER_PER_HUNDRED_CONSTRUCTION	Count of Housekeeping & Standing Water per 100 construction photos
HOUSEKEEPING_PER_HUNDRED_CONSTRUCTION	Count of Housekeeping per 100 construction photos
HOUSEKEEPING_COUNT	Count of assets tagged with “Housekeeping”
HOUSEKEEPING_AND_STANDING_WATER_COUNT	Count of assets tagged with “Housekeeping” or “Standing Water”
STANDING_WATER_PER_HUNDRED_CONSTRUCTION	Count of Standing Water per 100 construction photos
STANDING_WATER_COUNT	Count of assets tagged with “Standing Water”
PERSONS_PER_HUNDRED_CONSTRUCTION	Count of Persons per 100 construction photos
AVERAGE_PPE	Average PPE Compliance
PERSON_COUNT	Count of assets tagged with "Person"
PPE_INCIDENT_COUNT	Count of assets tagged with "No Glasses", "No Gloves", "No Hard Hat", "No Hi-Vis", "No Face Mask"
GLASSES_COMPLIANCE	Glasses Compliance (values 0-1)
GLOVE_COMPLIANCE	Gloves Compliance (values 0-1)
GLOVES_COMPLIANCE_FOR_PEOPLE_IN_GROUP	Gloves compliance for People in Group
HARD_HAT_COMPLIANCE	Hard Hat Compliance (values 0-1)
HI_VIS_COMPLIANCE	Hi-Vis Compliance (values 0-1)
GLASSES_INCIDENT_COUNT	Count of assets tagged with "No Glasses"
GLOVE_INCIDENT_COUNT	Count of assets tagged with "No Gloves"
HARD_HAT_INCIDENT_COUNT	Count of assets tagged with "No Hard Hat"
HI_VIS_INCIDENT_COUNT	Count of assets tagged with "No Hi-Vis"
AVG_CREATED_PER_DAY	Average number of assets created per day
AVG_CREATED_BY_DAY_OF_WEEK	Average number of assets created by day of week
AVG_DIFFERENCE_CREATED_UPLOADED	Average lag of uploading
PERCENT_OF_ASSETS_WITH_NO_CREATED_DATE	Percentage of photos with no created date
PERCENT_OF_CONSTRUCTION_ASSETS_WITH_NO_CREATED_DATE	Percentage of construction photos with no created date
PERSON_COVERAGE_PERCENT	Percentage of photos with people
PERCENT_FIT_OUT	Percentage of fit-out photos
PERCENT_FINISH_DETAIL	Percentage of Finish Detail photos
CONSTRUCTION_ACTIVITY_COUNT	Count of photos with Construction Activity tags in them
PROJECT_SCORE	Project’s overall weighted safety score as compared to other projects in organization
PERCENT_OF_PEOPLE_IN_GROUP	Percentage of assets with "Person in Group" tag
PEOPLE_IN_GROUP_COUNT	Count of assets with "Person in Group" tag
PERSON_AT_HEIGHT_PER_HUNDRED_CONSTRUCTION	Count of "person at height" tags per 100 construction photos
FACE_MASK_INCIDENT_COUNT	Count of instances without face mask
ASSETS_WITH_PEOPLE_COUNT	Count of images with people in them
FACE_MASK_COMPLIANCE	Face mask Compliance
FACE_MASK_COMPLIANCE_FOR_PEOPLE_IN_GROUP	Face mask compliance for People in Group
ACUTE_IBP_COUNT	Count of Acute IBP incidents
CHRONIC_IBP_COUNT	Count of Chronic IBP incidents
LADDER_USE_ISSUE_COUNT	Count of ladder use issues
SCAFFOLDING_ISSUE_COUNT	Count of tag "Guardrail Issue" - across all photos (including oxblue/truelook), regardless of confidence or Construction Tag
FALL_ARREST_COUNT	Count of tag "Fall Arrest Issue" - across all photos (including oxblue/truelook), regardless of confidence or Construction Tag
GUARDRAIL_ISSUE_COUNT	Count of tag "Guardrail Issue" - across all photos (including oxblue/truelook), regardless of confidence or Construction Tag
LADDER_SETUP_ISSUE_COUNT	Count of ladder setup issues
MEPI_ISSUE_COUNT	Count of MEPI issues
IMPALEMENT_HAZARD_COUNT	Count of impalement hazards
TRENCH_ISSUE_COUNT	Count of trench issues
STRUCTURAL_STEEL_COUNT	Count of assets tagged with “Structural Steel”
STRUCTURAL_STEEL_PER_HUNDRED_CONSTRUCTION	Count of “Structural Steel” per 100 construction photos
PERSON_AT_HEIGHT_COUNT	Count of assets tagged with “Person at Height”
UNSECURED_WORKER_AT_HEIGHT_COUNT	Count of assets tagged with “Unsecured Worker At Height”
UNSECURED_WORKER_AT_HEIGHT_PER_HUNDRED_CONSTRUCTION	Count of “Unsecured Worker At Height” per 100 construction photos
DUMPSTER_FULL_COUNT	Count of assets tagged with “Dumpster Full”
TRASH_BIN_FULL_COUNT	Count of assets tagged with “Trash Bin Full”
DUMPSTER_COUNT	Count of assets tagged with “Dumpster”
TRASH_BIN_COUNT	Count of assets tagged with “Trash Bin”
Observation Metrics
OBSERVATION_COUNT_TOTAL	Count of total observations
OBSERVATION_COUNT_BY_TYPE	Count of observations by type (POSITIVE, RISK)
OBSERVATION_POSITIVE_TO_RISK_RATIO	Positive-to-Risk Observation Ratio
OBSERVATION_RISK_COUNT_BY_HAZARD_CATEGORY	Count of risk observations by Hazard Category
OBSERVATION_POSITIVE_COUNT_BY_HAZARD_CATEGORY	Count of positive observations by Hazard Category
OBSERVATION_RISK_COUNT_BY_IDENTIFICATION_METHOD	Count of risk observations by Identification Method
OBSERVATION_POSITIVE_COUNT_BY_IDENTIFICATION_METHOD	Count of positive observations by Identification Method
OBSERVATION_RISK_COUNT_BY_RISK_BAND	Count of risk observations by Risk Band
OBSERVATION_RISK_COUNT_OPEN_BY_RISK_BAND	Count of currently open observations of type "Risk", grouped by Risk band (very similar to OBSERVATION_RISK_COUNT_OPEN_BY_STATUS)
OBSERVATION_RISK_COUNT_CLOSED_BY_RISK_BAND	Count of currently closed observations of type "Risk", grouped by Risk band (very similar to OBSERVATION_RISK_COUNT_OPEN_BY_RISK_BAND)
OBSERVATION_RISK_COUNT_BY_RISK_SCORE	Count of risk observations by Risk Score (1 - 25)
OBSERVATION_RISK_AVERAGE_RISK_SCORE	Average Risk Score for risk observations
OBSERVATION_RISK_MAXIMUM_RISK_SCORE	Maximum Risk Score for risk observations
OBSERVATION_GREAT_CATCH_COUNT_TOTAL	Count of the total number of observations marked as Great Catch
OBSERVATION_GREAT_CATCH_COUNT_BY_TYPE	Count of observations by type (POSITIVE, RISK) marked as Great Catch
OBSERVATION_RISK_GREAT_CATCH_AVERAGE_RISK_SCORE	Average Risk Score for risk observations marked as Great Catch
OBSERVATION_COUNT_OPEN_BY_TYPE	Count of open observations by type (POSITIVE, RISK)
OBSERVATION_COUNT_CLOSED_BY_TYPE	Count of closed observations by type (POSITIVE, RISK)
OBSERVATION_RISK_COUNT_OPEN_BY_STATUS	Count of risk observations by status
OBSERVATION_POSITIVE_COUNT_OPEN_BY_STATUS	Count of positive observations by status
OBSERVATION_RISK_AVERAGE_DAYS_OPEN	Number of average days open - for risk observations
OBSERVATION_RISK_AVERAGE_DAYS_OPEN_BY_RISK_BAND	Number of average days open by Risk Band - for risk observations
OBSERVATION_RISK_AVERAGE_DAYS_IT_TOOK_TO_CLOSE	Number of average days it took to close a risk observation opened in a non-Closed state
OBSERVATION_RISK_AVERAGE_DAYS_IT_TOOK_TO_CLOSE_BY_RISK_BAND	Number of average days it took to close a risk observation opened in a non-Closed state grouped by risk band
OBSERVATION_RISK_COUNT_PAST_DUE	Count of past due observations - for risk observations
OBSERVATION_RISK_COUNT_PAST_DUE_BY_RISK_BAND	Count of past due observations - for risk observations, grouped by risk band
OBSERVATION_RISK_AVERAGE_DAYS_LATENESS_FOR_PAST_DUE	Average lateness in days for past due observations - for risk observations
OBSERVATION_RISK_AVERAGE_DAYS_LATENESS_FOR_PAST_DUE_BY_RISK_BAND	Average lateness in days for past due observations - for risk observations, grouped by risk band
OBSERVATION_COUNT_BY_CREATOR	Count of observations by its creator
OBSERVATION_COUNT_BY_CREATOR_AND_TYPE	Count of observations by its creator by observation types (POSITIVE, RISK)
OBSERVATION_COUNT_OF_UNIQUE_CREATORS	Count of unique observation creators
OBSERVATION_COUNT_OF_UNIQUE_ASSIGNEES	Count of unique observation assignees

Get Metrics API

Returns a batch of metrics data. The API enables you to get multiple metric types and date ranges in a single request.

HTTP request

POST /api/v1/metrics/batch-get HTTP/1.1
Content-Type: application/json
Host: api-public.smartvid.io
Content-Length: 6186

{
  "organizationId" : "96a02c3d-58f6-4f0a-8e8b-cf24adb11312",
  "metricRequests" : [ {
    "objectType" : "ORGANIZATION_METRIC",
    "objectIds" : {
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_COUNT_TOTAL",
    "timeFrame" : "LAST_1",
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_COUNT_BY_TYPE",
    "timeFrame" : "LAST_90",
    "details" : {
      "observationType" : [ "NEGATIVE" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "ASSET_UPLOAD_COUNT",
    "timeFrame" : "LAST_1",
    "details" : {
      "assetType" : [ "IMAGE" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_GROUP_METRIC",
    "objectIds" : {
      "projectGroupId" : "058c85a0-9221-4c97-9c07-39895481aa69",
      "useExternalProjectId" : false
    },
    "metricName" : "TAG_INSTANCE_CREATION_COUNT",
    "timeFrame" : "LAST_30",
    "details" : {
      "tagType" : [ "MANUAL" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "ORGANIZATION_METRIC",
    "metricName" : "INTEGRATION_CREATED_COUNT",
    "timeFrame" : "LAST_7",
    "details" : {
      "integrationSourceType" : [ "BOX" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_RISK_COUNT_BY_RISK_SCORE",
    "timeFrame" : "LAST_1",
    "details" : {
      "riskScore" : [ "25" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "TRADE_PARTNER_METRIC",
    "objectIds" : {
      "tradePartnerId" : "983a6170-9f85-44d1-8245-745d4e017ea8",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_RISK_COUNT_BY_RISK_BAND",
    "timeFrame" : "LAST_1",
    "details" : {
      "riskBand" : [ "HIGH" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_RISK_COUNT_OPEN_BY_STATUS",
    "timeFrame" : "LAST_1",
    "details" : {
      "observationStatus" : [ "NEW" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_RISK_COUNT_BY_HAZARD_CATEGORY",
    "timeFrame" : "LAST_1",
    "details" : {
      "hazardCategory" : [ "Chemical Safety" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_RISK_COUNT_BY_IDENTIFICATION_METHOD",
    "timeFrame" : "LAST_1",
    "details" : {
      "identificationMethod" : [ "AI Detected" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "TRADE_PARTNER_USER_METRIC",
    "objectIds" : {
      "userId" : "1531edcc-0f0c-4b4f-ae95-f4a5e6943c2e",
      "tradePartnerId" : "983a6170-9f85-44d1-8245-745d4e017ea8",
      "useExternalProjectId" : false
    },
    "metricName" : "OBSERVATION_COUNT_BY_CREATOR",
    "timeFrame" : "LAST_1",
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "ORGANIZATION_METRIC",
    "metricName" : "INTEGRATION_CREATED_COUNT",
    "timeFrame" : "LAST_7",
    "aggregationType" : "AVG",
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "CONSTRUCTION_ACTIVITY_COUNT",
    "timeFrame" : "LAST_1",
    "details" : {
      "constructionActivity" : [ "CONCRETE_POUR" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "ORGANIZATION_METRIC",
    "metricName" : "USER_CREATED_COUNT",
    "timeFrame" : "LAST_7",
    "details" : {
      "userContentSourceType" : [ "WWW" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "INTEGRATION_UPLOADER_EXTERNAL_USER_COUNT",
    "timeFrame" : "LAST_7",
    "details" : {
      "integrationType" : [ "PROCORE" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  }, {
    "objectType" : "PROJECT_METRIC",
    "objectIds" : {
      "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
      "useExternalProjectId" : false
    },
    "metricName" : "AVG_CREATED_BY_DAY_OF_WEEK",
    "timeFrame" : "LAST_1",
    "details" : {
      "dayOfWeek" : [ "THURSDAY" ]
    },
    "startDate" : "2020-05-03",
    "endDate" : "2020-05-03",
    "page" : 0,
    "pageSize" : 60
  } ]
}

The request body contains data with the following structure:

Table 129. Request body
Path	Type	Description
`organizationId`	`String`	The internal ID of the organization the projects belong to
`metricRequests[].metricName`	`String`	Metric name. See the list of Supported Metrics above
`metricRequests[].objectType`	`String`	Metric object type. All metrics are grouped by the following object types PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC, TRADE_PARTNER_USER_METRIC. Find which object types and metrics can be queried together in the Metrics Details table
`metricRequests[].objectIds`	`Object`	List of identifiers for which the metric was calculated
`metricRequests[].objectIds.projectId`	`String`	The internal or external project ID. Mandatory for the following object types: PROJECT_METRIC, PROJECT_USER_METRIC
`metricRequests[].objectIds.projectGroupId`	`String`	The internal project group ID. Mandatory for the following object types: PROJECT_GROUP_METRIC, PROJECT_GROUP_USER_METRIC
`metricRequests[].objectIds.userId`	`String`	The internal user ID Mandatory for the following object types: PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC
`metricRequests[].objectIds.tradePartnerId`	`String`	The internal trade partner ID. Mandatory for the following object types: TRADE_PARTNER_METRIC, TRADE_PARTNER_USER_METRIC
`metricRequests[].objectIds.useExternalProjectId`	`Boolean`	Use the projectId field as the project ID in the external system
`metricRequests[].timeFrame`	`String`	Time frame for rolling window metrics. Can have one of the following values LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
`metricRequests[].startDate`	`String`	The start date for the query in ISO8601 date format YYYY-MM-DD
`metricRequests[].endDate`	`String`	The end date for the query in ISO8601 date format YYYY-MM-DD
`metricRequests[].page`	`Number`	The page number
`metricRequests[].pageSize`	`Number`	Number of metrics per page. (default is 60)
`metricRequests[].aggregationType`	`String`	Optional type of results aggregation. Can have one of the following values AVG, SUM, MAX
`metricRequests[].details`	`Object`	Possible options for searching the metrics by its details. It’s optional. Find what details and metrics can be queried together in the Metrics Details table
`metricRequests[].details.observationType`	`Array`	Can have one of the following values: POSITIVE, NEGATIVE. Available for the following metrics: OBSERVATION_COUNT_CLOSED_BY_TYPE, OBSERVATION_COUNT_OPEN_BY_TYPE, OBSERVATION_COUNT_BY_CREATOR_AND_TYPE, OBSERVATION_COUNT_BY_TYPE, OBSERVATION_GREAT_CATCH_COUNT_BY_TYPE
`metricRequests[].details.observationStatus`	`Array`	Can have one of the following values: NEW, IN_PROGRESS, WITH_PARTNER, DELAYED, CLOSED, READY_TO_REVIEW, CLOSED_REVIEWED, OBSERVED, NOT_APPLICABLE. Available for the following metrics: OBSERVATION_POSITIVE_COUNT_OPEN_BY_STATUS, OBSERVATION_RISK_COUNT_OPEN_BY_STATUS
`metricRequests[].details.hazardCategory`	`Array`	The hazard category. Available for the following metrics: OBSERVATION_POSITIVE_COUNT_BY_HAZARD_CATEGORY, OBSERVATION_RISK_COUNT_BY_HAZARD_CATEGORY
`metricRequests[].details.identificationMethod`	`Array`	The method of identification. Available for the following metrics: OBSERVATION_POSITIVE_COUNT_BY_IDENTIFICATION_METHOD, OBSERVATION_RISK_COUNT_BY_IDENTIFICATION_METHOD
`metricRequests[].details.riskScore`	`Array`	This is a risk score. Value from 1 to 25. Available for the following metrics: OBSERVATION_RISK_COUNT_BY_RISK_SCORE
`metricRequests[].details.riskBand`	`Array`	Can have one of the following values: EXTREME, HIGH, MEDIUM, LOW. Available for the following metrics: OBSERVATION_RISK_AVERAGE_DAYS_LATENESS_FOR_PAST_DUE_BY_RISK_BAND, OBSERVATION_RISK_COUNT_CLOSED_BY_RISK_BAND, OBSERVATION_RISK_COUNT_BY_RISK_BAND, OBSERVATION_RISK_COUNT_PAST_DUE_BY_RISK_BAND, OBSERVATION_RISK_AVERAGE_DAYS_OPEN_BY_RISK_BAND, OBSERVATION_RISK_AVERAGE_DAYS_IT_TOOK_TO_CLOSE_BY_RISK_BAND, OBSERVATION_RISK_COUNT_OPEN_BY_RISK_BAND
`metricRequests[].details.assetType`	`Array`	Can have one of the following values: TOTAL, VIDEO, IMAGE, IMAGE_AUDIO, SPHERICAL_IMAGE, OTHER. Available for the following metrics: ASSET_CREATED_COUNT, USER_ASSET_CREATED_COUNT, ASSET_UPLOAD_COUNT
`metricRequests[].details.tagType`	`Array`	Can have one of the following values: TOTAL, MANUAL, ASR, IMREC, INTEGRATION. Available for the following metrics: USER_TAG_INSTANCE_CREATION_COUNT, TAG_INSTANCE_CREATION_COUNT
`metricRequests[].details.integrationSourceType`	`Array`	Can have one of the following values: TOTAL, SHAREPOINT, PROCORE, BIM360_FIELD, EGNYTE, FORGE, FORGE_ISSUE, OXBLUE, BOX, ACONEX. Available for the following metrics: INTEGRATION_CREATED_COUNT
`metricRequests[].details.integrationType`	`Array`	Can have one of the following values: TOTAL, PROCORE, BIM360_FIELD, EGNYTE, FORGE, FORGE_ISSUE, FORGE_CHECKLIST_INSTANCE, FORGE_ISSUE_CREATED, OXBLUE, BOX, ACONEX. Available for the following metrics: INTEGRATION_EXTERNAL_USER_ASSET_CREATED_COUNT, INTEGRATION_UPLOADER_EXTERNAL_USER_COUNT
`metricRequests[].details.userContentSourceType`	`Array`	Can have one of the following values: TOTAL, UNKNOWN, WWW, ANDROID, IOS, API. Available for the following metrics: USER_CREATED_COUNT
`metricRequests[].details.constructionActivity`	`Array`	Can have one of the following values: CONCRETE_POUR, DEMOLITION, EXCAVATION, FOUNDATION, MEP, TRENCH_WORK. Available for the following metrics: CONSTRUCTION_ACTIVITY_COUNT
`metricRequests[].details.dayOfWeek`	`Array`	Can have one of the following values: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. Available for the following metrics: AVG_CREATED_BY_DAY_OF_WEEK

HTTP response

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1807

{
  "metrics" : [ {
    "metricName" : "OBSERVATION_COUNT_TOTAL",
    "timeFrame" : "LAST_1",
    "value" : 10.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.0",
    "organizationId" : "96a02c3d-58f6-4f0a-8e8b-cf24adb11312",
    "objectType" : "ORGANIZATION_METRIC"
  }, {
    "metricName" : "OBSERVATION_COUNT_BY_TYPE",
    "timeFrame" : "LAST_90",
    "details" : "NEGATIVE",
    "value" : 10.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.0",
    "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
    "objectType" : "PROJECT_METRIC"
  }, {
    "metricName" : "TAG_INSTANCE_CREATION_COUNT",
    "timeFrame" : "LAST_30",
    "details" : "MANUAL",
    "value" : 10.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.1",
    "projectGroupId" : "058c85a0-9221-4c97-9c07-39895481aa69",
    "objectType" : "PROJECT_GROUP_METRIC"
  }, {
    "metricName" : "TAG_INSTANCE_CREATION_COUNT",
    "timeFrame" : "LAST_30",
    "details" : "MANUAL",
    "value" : 99.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.1",
    "aggregationType" : "AVG",
    "projectGroupId" : "058c85a0-9221-4c97-9c07-39895481aa69",
    "objectType" : "PROJECT_GROUP_METRIC"
  }, {
    "metricName" : "OBSERVATION_COUNT_BY_CREATOR",
    "timeFrame" : "LAST_1",
    "value" : 10.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.0",
    "tradePartnerId" : "983a6170-9f85-44d1-8245-745d4e017ea8",
    "userId" : "1531edcc-0f0c-4b4f-ae95-f4a5e6943c2e",
    "objectType" : "TRADE_PARTNER_USER_METRIC"
  }, {
    "metricName" : "CONSTRUCTION_ACTIVITY_COUNT",
    "timeFrame" : "LAST_1",
    "details" : "CONCRETE_POUR",
    "value" : 10.0,
    "metricDate" : "2020-05-03",
    "version" : "1.0.1",
    "projectId" : "7fdae47c-628d-4eee-83a2-78635ea14d54",
    "objectType" : "PROJECT_METRIC"
  } ]
}

If successful, the response body contains data with the following structure:

Table 130. Response body
Path	Type	Description
`metrics[].metricName`	`String`	Metric name. See the list of Supported Metrics above
`metrics[].objectType`	`String`	Metric object type. Can have one of the following values PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC, TRADE_PARTNER_USER_METRIC
`metrics[].timeFrame`	`String`	Time frame for rolling window metrics. Can have one of the following values LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
`metrics[].value`	`Number`	Metric value
`metrics[].details`	`String`	Metric details. See Metrics Details table
`metrics[].metricDate`	`String`	The date for which the metric was calculated (in ISO8601 format YYYY-MM-DD)
`metrics[].version`	`String`	Metric version
`metrics[].projectId`	`String`	The internal project ID
`metrics[].projectGroupId`	`String`	The internal project group ID
`metrics[].organizationId`	`String`	The internal organization ID
`metrics[].tradePartnerId`	`String`	The internal trade partner ID
`metrics[].aggregationType`	`String`	Type of results aggregation. Can have one of the following values , [Lio.smartvid.model.metrics.MetricAggregationType;@63d52309
`metrics[].userId`	`String`	The internal user ID

Not all object types and metrics can be requested together. Refer to the following table for object types, details, and time periods corresponding to which metrics.

Table 131. Metrics Details
Metric Name	Object Types	Time Frames	Details
Activity Metrics
ASSET_UPLOAD_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, VIDEO, IMAGE IMAGE_AUDIO, SPHERICAL_IMAGE, OTHER
ASSET_CREATED_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, VIDEO, IMAGE IMAGE_AUDIO, SPHERICAL_IMAGE, OTHER
AVG_UPLOAD_PER_DAY	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
TAG_INSTANCE_CREATION_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, MANUAL, ASR, IMREC, INTEGRATION
UPLOADER_USER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ACTIVE_USER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
INTEGRATION_CREATED_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, UNKNOWN, WWW, ANDROID, IOS, API
USER_CREATED_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, UNKNOWN, WWW, ANDROID, IOS, API
INTEGRATION_UPLOADER_EXTERNAL_USER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, PROCORE, BIM360_FIELD, EGNYTE, FORGE, FORGE_ISSUE, FORGE_CHECKLIST_INSTANCE, FORGE_ISSUE_CREATED, OXBLUE, BOX, ACONEX
INTEGRATION_EXTERNAL_USER_ASSET_CREATED_COUNT	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, PROCORE, BIM360_FIELD, EGNYTE, FORGE, FORGE_ISSUE, FORGE_CHECKLIST_INSTANCE, FORGE_ISSUE_CREATED, OXBLUE, BOX, ACONEX
USER_ASSET_CREATED_COUNT	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, VIDEO, IMAGE IMAGE_AUDIO, SPHERICAL_IMAGE, OTHER
USER_TAG_INSTANCE_CREATION_COUNT	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	TOTAL, MANUAL, ASR, IMREC, INTEGRATION
USER_COMMENT_COUNT	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
AVG_CREATED_PER_DAY	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
AVG_CREATED_BY_DAY_OF_WEEK	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
AVG_DIFFERENCE_CREATED_UPLOADED	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERCENT_OF_ASSETS_WITH_NO_CREATED_DATE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERCENT_OF_CONSTRUCTION_ASSETS_WITH_NO_CREATED_DATE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
Safety Metrics
CONSTRUCTION_ASSET_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CONSTRUCTION_PHOTO_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CONSTRUCTION_TO_TOTAL_ASSET_RATIO	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
BULLDOZER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PICKUP_TRUCK_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
BOX_TRUCK_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FRONT_END_LOADER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
BACKHOE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CONCRETE_MIXER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CONCRETE_PUMP_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
DRILL_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
MOBILE_CRANE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
EXCAVATOR_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ALL_LADDERS_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
LADDER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FOLDING_LADDER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
EXTENSION_LADDER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
SITE_LADDER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PLATFORM_LADDER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ACCESS_PLATFORM_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ALL_LIFTS_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
BOOM_LIFT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
SCISSOR_LIFT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
SCAFFOLDING_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
STAIRWAY_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
EXPOSED_HOLE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
SOCIAL_DISTANCE_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
WAH_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
LADDER_TO_LIFT_RATIO	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HOUSEKEEPING_AND_STANDING_WATER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HOUSEKEEPING_AND_STANDING_WATER_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HOUSEKEEPING_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HOUSEKEEPING_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
STANDING_WATER_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
STANDING_WATER_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERSONS_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
AVERAGE_PPE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERSON_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PPE_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GLASSES_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GLOVE_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GLOVES_COMPLIANCE_FOR_PEOPLE_IN_GROUP	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HARD_HAT_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HI_VIS_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FACE_MASK_COMPLIANCE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FACE_MASK_COMPLIANCE_FOR_PEOPLE_IN_GROUP	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FACE_MASK_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ASSETS_WITH_PEOPLE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GLASSES_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GLOVE_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HARD_HAT_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
HI_VIS_INCIDENT_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERSON_COVERAGE_PERCENT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERCENT_FIT_OUT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERCENT_FINISH_DETAIL	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CONSTRUCTION_ACTIVITY_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	CONCRETE_POUR, DEMOLITION, EXCAVATION, FOUNDATION, MEP, TRENCH_WORK
PROJECT_SCORE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERCENT_OF_PEOPLE_IN_GROUP	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PEOPLE_IN_GROUP_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
PERSON_AT_HEIGHT_PER_HUNDRED_CONSTRUCTION	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
ACUTE_IBP_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
CHRONIC_IBP_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
LADDER_USE_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
GUARDRAIL_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
FALL_ARREST_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
SCAFFOLDING_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
LADDER_SETUP_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
MEPI_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
IMPALEMENT_HAZARD_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
TRENCH_ISSUE_COUNT	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
Observation Metrics
OBSERVATION_COUNT_TOTAL	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_COUNT_BY_TYPE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, NEGATIVE
OBSERVATION_POSITIVE_TO_RISK_RATIO	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_COUNT_BY_HAZARD_CATEGORY	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_POSITIVE_COUNT_BY_HAZARD_CATEGORY	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_COUNT_BY_IDENTIFICATION_METHOD	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_POSITIVE_COUNT_BY_IDENTIFICATION_METHOD	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_COUNT_OPEN_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_COUNT_CLOSED_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_COUNT_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_COUNT_BY_RISK_SCORE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_AVERAGE_RISK_SCORE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_MAXIMUM_RISK_SCORE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_GREAT_CATCH_COUNT_TOTAL	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_GREAT_CATCH_COUNT_BY_TYPE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, NEGATIVE
OBSERVATION_RISK_GREAT_CATCH_AVERAGE_RISK_SCORE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_COUNT_OPEN_BY_TYPE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, NEGATIVE
OBSERVATION_COUNT_CLOSED_BY_TYPE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, NEGATIVE
OBSERVATION_RISK_COUNT_OPEN_BY_STATUS	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	NEW, IN_PROGRESS, WITH_PARTNER, DELAYED, CLOSED, READY_TO_REVIEW, CLOSED_REVIEWED, OBSERVED, NOT_APPLICABLE
OBSERVATION_POSITIVE_COUNT_OPEN_BY_STATUS	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	NEW, IN_PROGRESS, WITH_PARTNER, DELAYED, CLOSED, READY_TO_REVIEW, CLOSED_REVIEWED, OBSERVED, NOT_APPLICABLE
OBSERVATION_RISK_AVERAGE_DAYS_OPEN	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_AVERAGE_DAYS_OPEN_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_AVERAGE_DAYS_IT_TOOK_TO_CLOSE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_AVERAGE_DAYS_IT_TOOK_TO_CLOSE_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_COUNT_PAST_DUE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_COUNT_PAST_DUE_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_RISK_AVERAGE_DAYS_LATENESS_FOR_PAST_DUE	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_RISK_AVERAGE_DAYS_LATENESS_FOR_PAST_DUE_BY_RISK_BAND	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, EXTREME, HIGH, MEDIUM, LOW, UNKNOWN, RISK
OBSERVATION_COUNT_BY_CREATOR	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC, TRADE_PARTNER_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_COUNT_BY_CREATOR_AND_TYPE	PROJECT_USER_METRIC, PROJECT_GROUP_USER_METRIC, ORGANIZATION_USER_METRIC, TRADE_PARTNER_USER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH	POSITIVE, NEGATIVE
OBSERVATION_COUNT_OF_UNIQUE_CREATORS	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH
OBSERVATION_COUNT_OF_UNIQUE_ASSIGNEES	PROJECT_METRIC, PROJECT_GROUP_METRIC, ORGANIZATION_METRIC, TRADE_PARTNER_METRIC, PROJECT_TRADE_PARTNER_METRIC, PROJECT_GROUP_TRADE_PARTNER_METRIC, ORGANIZATION_TRADE_PARTNER_METRIC	LAST_1, LAST_7, LAST_30, LAST_60, LAST_90, WEEK_TO_DATE, MONTH_TO_DATE, CALENDAR_MONTH