ISisometric

Get Datapoint

Changed on

Returns a single datapoint in the Isometric system

get/datapoints/{id}

Request

  • Base URL
    https://api.isometric.com/mrv/v0
  • URL
    https://api.isometric.com/mrv/v0/datapoints/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:dtp_1DVKHKS101S0Q61Q

Headers

x-client-secretstring required

A secret token identifying the client connecting to the API

Example:Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP

Response

Successful Response

idstring required
supplier_reference_idstring nullable required

A string that must be unique for all resources created by a specific supplier. It can be used by a client to identify the correct objects in their system.

display_namestring required
type'CONSTANT' | 'STANDARD_PUBLISHED_VALUE' | 'REPORTED' | 'ASSUMPTION' | 'DERIVED' required
descriptionstring nullable required
source_idsstring[] required
measured_atstring date-time nullable required
project_idstring nullable required
locked_status'not_locked' | 'locked_library_datapoint' | 'locked_time_series_datapoint' | 'locked_measurement_sample_datapoint' | 'locked_forestry_field_measurement_datapoint' | 'locked_model_output_datapoint' | 'locked_model_input_datapoint' | 'locked_material_datapoint' | 'locked_activity_datapoint' | 'locked_used_in_verified_removal' required

Represents the locked status of a Datapoint. Locked Datapoints cannot be updated: if an updated version of a data input is required then a new Datapoint must be created.

uncertainty_justificationstring nullable

Provide an uncertainty justification where required for inputs identified as sensitive in sensitivity analysis.

Example response

{
  "id": "dtp_1DVKHKS101S0Q61Q",
  "source_ids": [
    "src_1EBBF4M7X1S06G1Y"
  ],
  "project_id": "prj_1CTWZQGKE1S0VAXA"
}

Changes

  • e0d342ff70d6Revision changes
    • breaking

      for the path request parameter id, the minLength was increased from 0 to 20

    • warning

      for the path request parameter id, the maxLength was set to 37

    • info

      for the path request parameter id, the type was generalized from no type to string

  • a29120dd7406Revision changes
    • breaking

      the / response property's maxLength was increased from 100 to 200 for the response status

    • warning

      added the new locked_activity_datapoint enum value to the response property for the response status

    • warning

      added the new locked_forestry_field_measurement_datapoint enum value to the response property for the response status

    • warning

      added the new locked_material_datapoint enum value to the response property for the response status

    • warning

      added the new locked_model_input_datapoint enum value to the response property for the response status

    • warning

      added the new locked_model_output_datapoint enum value to the response property for the response status

    • info

      for the path request parameter id, the type was generalized from string to no type

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status