---
title: "Meter an event"
method: POST
path: "/v2/events"
tags: ["Event Metering"]
---

# Meter an event

`POST /v2/events`

Meter an event

## Request body

- MeteringEvent — The metering event
  - `transactionId` string, required — The unique identifier of the metering event
  - `payload` string, required — The rating payload as a JSON object. For example, if you are sending key value pairs of 'requestTokens' and 'responseTokens' with values of '1' and '2' respectively, the payload would be { "requestTokens": "1", "responseTokens": "2"}. If these keys do not already exist in Revenium, each key you send will be configured as a metering element on the relevant data source.
  - `sourceId` string — the sourceId
  - `subscriberCredentialId` string — The unique identifier of the credential
  - `sourceType` 'UNKNOWN' | 'AI' | 'SDK_PYTHON' | 'SDK_JS' | 'SDK_JVM' | 'SDK_SPRING' | 'SDK_DOTNET' | 'SDK_GOLANG' | 'SDK_RUST' | 'EBPF' | 'AWS' | 'AZURE' | 'SNOWFLAKE' | 'KONG' | 'GRAVITEE' | 'MULESOFT' | 'BOOMI' | 'REVENIUM' | 'INTERNAL', required — the source type

## Response `201`

API response successfully metered

- MeteringResponseResource — Metering response resource details for the metering API, providing metadata about response creation and validation.
  - `object` string, required — Type of the object, typically 'metering'
  - `label` string, required — A descriptive label for the metering response
  - `created` string — ISO8601 formatted timestamp when the response was created
  - `updated` string — ISO8601 formatted timestamp when the response was last updated
  - `id` string, required — Unique identifier for the metering response
  - `signature` string, required — Signature used for validating the response data
  - `_links` Links

## Other responses

- `400` — Invalid input data
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found
- `409` — Conflict

---

[API](https://skmtc.net/revenium/apis/revenium-metering-api.md) · [All operations](https://skmtc.net/revenium/apis/revenium-metering-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/revenium/revenium-metering-api/versions/8fb79ecfebda/schema)