Skip to main content
POST
billing.passthrough.record

Authorizations

Authorization
string
header
required

A Lath API key: lath_live_sk… or lath_test_sk… on a server, lath_live_pk… or lath_test_pk… in a browser.

Headers

Idempotency-Key
string

Replays the stored response for the same key and input; refuses different input.

Body

application/json
metric
enum<string>
required

Which pass-through line this belongs to

Available options:
sms.registration
description
string
required

What the fee was for, as it should read on the bill

Required string length: 1 - 200
amountCents
integer
required

The amount actually charged, in cents. Zero is allowed: a waived fee is still worth showing.

Required range: 0 <= x <= 1000000
providerRef
string

The carrier's own reference. Recording the same one twice is refused, which is what makes a retry safe.

Required string length: 1 - 200
period
string

Calendar month, UTC, as YYYY-MM. Defaults to the current month.

Pattern: ^\d{4}-(0[1-9]|1[0-2])$

Response

{ activityId, result }. activityId is empty for reads.

activityId
string
required

The activity this call created, or empty for a read.

result
object
required
Last modified on September 13, 2026