---
title: "POST /api/v1/metering/report"
method: POST
path: "/api/v1/metering/report"
tags: ["api"]
---

# POST /api/v1/metering/report

`POST /api/v1/metering/report`

Append one metered usage fact. Deduplicated by ``idempotency_key``.

## Request body

- MeteringReport
  - `project_id` string, uuid, required — Project UUID (``Project.pid``) this usage rolls up to.
  - `resource_kind` string, required
  - `resource_id` string, required
  - `interval_start` string, date-time, required
  - `interval_end` string, date-time, required
  - `metrics` object, required — Open metric payload (network_bytes, storage_bytes, …).
  - `idempotency_key` string, required
  - `kind` 'JOB_CLOSE' | 'DATA_DELETE' | 'ADJUSTMENT' | 'DELTA_SLICE'
  - `source_ref` string
  - `reporter` string — Emitting service (e.g. bitmaker-proxy). Defaults to estela.
  - `adjustment_reason` 'RECONCILE_SCRAPY_FINAL' | 'RECONCILE_STORAGE' | 'MANUAL'

## Response `200`

OK

- MeteringReportResponse
  - `id` string, uuid, required
  - `recorded_at` string, date-time, required
  - `duplicate` boolean, required
  - `resource_kind` string, required
  - `resource_id` string, required

## Other responses

- `201` — Created

---

[API](https://skmtc.net/bitmakerla/apis/estela-api-v1-0-documentation.md) · [All operations](https://skmtc.net/bitmakerla/apis/estela-api-v1-0-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitmakerla/estela-api-v1-0-documentation/versions/ec53774a2b78/schema)