Meter an API response

post

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

Send this when your API returns a response. Use the same transactionId as the matching request sent to POST /v2/apis/requests.

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/responses 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

Time in milliseconds spent in the services behind your API, excluding gateway overhead.

gatewayLatency

double | null

The latency introduced by the gateway in milliseconds

Headers

Idempotency-Key

string

length between 1 and 255

^[!-~]+$

Optional key that makes retries safe. Revenium stores the response for each key in your account and replays it if you retry with the same key. Reusing a key with a different request body returns 409 idempotency_key_mismatch; retrying while the first request is still in progress 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. If the Idempotency-Key header is invalid, the body is an invalid_idempotency_key error. If the request body is malformed or fails validation, the body is an ApiError.

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

429Rate limit exceeded. Retry after the indicated delay.

500Internal server error

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

504Gateway Timeout