---
title: "Metering Measurements"
method: GET
path: "/v2/org/{org-name}/metering"
tags: ["Metering"]
---

# Metering Measurements

`GET /v2/org/{org-name}/metering`

Returns Private Registry / EGX resources usage metering as measurement series. Requires admin privileges for organization.

## Path parameters

- `org-name` string, required

## Query parameters

- `q` MeteringQueryRequest, required — request params for getting metering usage
  - `measurements` MeteringQueryParams[]
    - `toDate` string — start time range for the data, in ISO formate, yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    - `periodInSeconds` number, float — time period to aggregate the data over with, in seconds. If none provided, raw data will be returned.
    - `fromDate` string — end time range for the data, in ISO formate, yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
    - `type` 'EGX_GPU_UTILIZATION_DAILY' | 'FLEET_COMMAND_GPU_UTILIZATION_DAILY' | 'EGX_LOG_STORAGE_UTILIZATION_DAILY' | 'FLEET_COMMAND_LOG_STORAGE_UTILIZATION_DAILY' | 'REGISTRY_STORAGE_UTILIZATION_DAILY' | 'EGX_GPU_UTILIZATION_MONTHLY' | 'FLEET_COMMAND_GPU_UTILIZATION_MONTHLY' | 'EGX_LOG_STORAGE_UTILIZATION_MONTHLY' | 'FLEET_COMMAND_LOG_STORAGE_UTILIZATION_MONTHLY' | 'REGISTRY_STORAGE_UTILIZATION_MONTHLY'
    - `groupBy` string[] — group by specific tags
    - `fill` number, float — this replaces all null values in an output stream with a non-null value that is provided.

## Headers

- `Content-Type` string, required

## Response `200`

OK

- MeteringResultListResponse — response containing a list of all metering queries results
  - `measurements` MeasurementResult[]
    - `series` MeasurementSeries[] — array of series within a measurement
      - `values` Measurement[] — array of values, in the same order as the columns, for the series.
        - `value` string[] — list of values, in the same order as columns
      - `name` string — name for the measurement
      - `columns` string[] — list of columns, in order, for the series.
      - `tags` MeasurementTag[] — list of tags identifying the series.
        - `tagKey` string — key for the tag, ie)host, job_id, gpu_id
        - `tagValue` string — value for the tag, ie)host=foo, job_id=bar, gpu_id=racecar
  - `requestStatus` RequestStatus
    - `serverId` string
    - `statusCode` 'UNKNOWN' | 'SUCCESS' | 'UNAUTHORIZED' | 'PAYMENT_REQUIRED' | 'FORBIDDEN' | 'TIMEOUT' | 'EXISTS' | 'NOT_FOUND' | 'INTERNAL_ERROR' | 'INVALID_REQUEST' | 'INVALID_REQUEST_VERSION' | 'INVALID_REQUEST_DATA' | 'METHOD_NOT_ALLOWED' | 'CONFLICT' | 'UNPROCESSABLE_ENTITY' | 'TOO_MANY_REQUESTS' | 'INSUFFICIENT_STORAGE' | 'SERVICE_UNAVAILABLE' | 'PAYLOAD_TOO_LARGE' | 'NOT_ACCEPTABLE' | 'UNAVAILABLE_FOR_LEGAL_REASONS' | 'BAD_GATEWAY' — Describes response status reported by the server.
    - `statusDescription` string
    - `requestId` string

## Other responses

- `302` — Found
- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `415` — Unsupported Media Type
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `451` — Unavailable For Legal Reasons
- `500` — Internal Server Error
- `501` — Not Implemented
- `502` — Bad Gateway
- `503` — Service Unavailable

---

[API](https://skmtc.net/brevdev/apis/ngc-api-documentation.md) · [All operations](https://skmtc.net/brevdev/apis/ngc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brevdev/ngc-api-documentation/revisions/7f0aa99cc03e/schema)