---
title: "POST /metrics/query/datapoints"
method: POST
path: "/metrics/query/datapoints"
---

# POST /metrics/query/datapoints

`POST /metrics/query/datapoints`

## Request body

- MetricsDatapointsQueryRequest
  - `dimension` 'month' | 'year', required
  - `endMonth` string, required
  - `filters` MetricsFilter[]
    - `field` 'factor_scope' | 'factor_region' | 'factor_category' | 'activity_unit', required
    - `operator` 'is' | 'is-not' | 'including' | 'not-including' | 'is-empty' | 'is-not-empty', required
    - `value` string
  - `groupBy` MetricsLabelField[]
  - `measures` MetricsDatapointMeasureRequest[], required
    - `aggregation` 'SUM' | 'AVG' | 'MAX' | 'MIN' | 'COUNT', required
    - `baseParameter` 'emission' | 'raw', required
  - `startMonth` string, required

## Response `200`

OK

- MetricsDatapointsQueryResponse
  - `data` object, required
    - `datapoints` object[], required
  - `meta` object

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/09945036a28b/schema)