---
title: "Get Datapoints"
method: GET
path: "/datapoints"
---

# Get Datapoints

`GET /datapoints`

Lists datapoints in the Isometric system

## Query parameters

- `supplier_reference_id` string, nullable — 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_name_contains` string, nullable
- `project_id` string
- `quantity_kind` 'acidity' | 'activity_concentration' | 'amount_of_substance' | 'amount_of_substance_concentration' | 'amount_of_substance_per_mass' | 'area' | 'area_carbon_emission_factor' | 'buffer_ph' | 'bulk_density' | 'count' | 'currency' | 'currency_carbon_emission_factor' | 'depth' | 'diameter' | 'diameter_at_breast_height' | 'dimensionless' | 'dimensionless_ratio' | 'distance' | 'distance_carbon_emission_factor' | 'dose_equivalent_rate' | 'electric_current' | 'elevation' | 'energy' | 'energy_carbon_emission_factor' | 'energy_density' | 'exchangeable_amount_of_substance_per_mass' | 'fuel_economy' | 'height' | 'ionic_strength' | 'latitude' | 'longitude' | 'mass' | 'mass_carbon' | 'mass_carbon_emission_factor' | 'mass_cdr_potential' | 'mass_concentration' | 'mass_density' | 'mass_distance' | 'mass_distance_carbon_emission_factor' | 'mass_energy_density' | 'mass_flow_rate' | 'mass_fraction' | 'mass_fraction_dry_basis' | 'mass_fraction_wet_basis' | 'mass_per_area' | 'mass_ratio' | 'molality_of_solute' | 'molar_mass' | 'mole_fraction' | 'partial_pressure' | 'particle_diameter' | 'particle_mass_density' | 'power' | 'pressure' | 'specific_surface_area' | 'specific_volume' | 'temperature' | 'time' | 'time_emission_factor' | 'voltage' | 'volume' | 'volume_carbon_emission_factor' | 'volume_distance_carbon_emission_factor' | 'volume_flow_rate' | 'volume_fraction' | 'volume_per_area'
- `measurement_sample_id` string
- `used_in_ghg_entry` string
- `used_in_removal` string
- `used_in_ghg_statement` string
- `used_in_ghg_entry_template` string
- `used_in_removal_template` string
- `used_in_scope` 'REMOVAL' | 'GHG_STATEMENT' | 'PROJECT' | 'NET_NEGATIVITY'
- `last` integer — An integer number of items to retrieve before the item represented by the cursor passed in the before parameter. Defaults to 10 with a maximum value of 50.
- `before` string, nullable — An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor here when paginated backwards.
- `first` integer — An integer number of items to retrieve after the item represented by the cursor passed in the after parameter. Defaults to 10 with a maximum value of 50.
- `after` string, nullable — An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor here when paginated forwards.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Response `200`

Successful Response

- PaginatedListResourceDatapoint
  - `nodes` Datapoint[], required
    - `id` string, required
    - `supplier_reference_id` string, 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_name` string, required
    - `type` 'CONSTANT' | 'STANDARD_PUBLISHED_VALUE' | 'REPORTED' | 'ASSUMPTION' | 'DERIVED', required
    - `quantity` ScalarQuantity, required
      - `magnitude` number, required
      - `unit` string, required
      - `standard_deviation` number, nullable
    - `description` string, nullable, required
    - `source_ids` string[], required
    - `measured_at` string, date-time, nullable, required
    - `project_id` string, 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_justification` string, nullable — Provide an uncertainty justification where required for inputs identified as sensitive in sensitivity analysis.
  - `total_count` integer, required
  - `page_info` PageInfo, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `end_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-certify-data-ingestion-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-certify-data-ingestion-api/versions/9819e9c8ccf0/schema)