Meter an API response

post

https://api.revenium.ai/meter/v2/apis/responses

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The metadata for the API response

transactionId

string

required

A client-supplied unique identifier used to correlate request and response pairs across /meter/v2/apis/requests and /meter/v2/apis/response endpoints. Must be consistent between related API calls to ensure proper usage tracking and analytics.

totalDuration

int64 | null

The total duration of the request processing in milliseconds

responseCode

int32

required

The HTTP status code of the response

responseMessageSize

int64 | null

The size of the response message in bytes

contentType

string | null

The content type of the request

backendLatency

double | null

The latency introduced by backend services in milliseconds

gatewayLatency

double | null

The latency introduced by the gateway in milliseconds

Headers

Idempotency-Key

string

length between 1 and 255

^[!-~]+$

Optional Stripe-style retry-safety key. If present, the response (status + body) is cached keyed by (tenant, key). Identical retries replay the cached response; body mismatch returns 409 idempotency_key_mismatch; a concurrent in-flight call returns 409 idempotency_key_in_progress with Retry-After: 1. Must be 1-255 printable ASCII characters; UUID v4 recommended. See https://docs.revenium.io/integrations/idempotency for full behavior.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

201Returns the created metering response object.

400Bad request. Either invalid_idempotency_key from the idempotency filter (canonical envelope), or a controller-level body parse / @Valid failure (legacy ApiError envelope). The two will converge to a single schema once the v2 error envelope unification lands.

401Unauthorized - Authentication required

403Forbidden. The API key scope is not allowed to post to metering endpoints. Use a key with METERING (rev_mk_), WRITE (rev_sk_), or legacy (hak_) scope.

404Resource not found

409Idempotency conflict. idempotency_key_mismatch when the same Idempotency-Key was reused with a different request body. idempotency_key_in_progress when a concurrent request with the same key is still in flight; in that case the response carries a Retry-After header.

413Request body exceeds the maximum size buffered by the idempotency filter.

422Unprocessable entity

429Too Many Requests

500Internal server error

503Idempotency cache backing store is temporarily unavailable. Retry later.