Skip to main content
GET
/
meters
/
{id}
Get a meter
curl --request GET \
  --url https://api.lavapayments.com/v1/meters/{id} \
  --header 'Authorization: Bearer <token>'
{
  "meter_id": "<string>",
  "meter_secret": "<string>",
  "name": "<string>",
  "rate_type": "fixed",
  "token_basis": "input+output",
  "base_cost_payer": "merchant",
  "service_charge_payer": "merchant",
  "tiers": [
    {
      "start": 123,
      "rate": "<string>",
      "type": "tokens_1m"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication used for standard API calls. Format: 'Bearer YOUR_API_KEY'

Path Parameters

​
id
string
required

Meter ID

Response

Meter details

​
meter_id
string
required

Unique identifier for the meter

​
meter_secret
string
required

Secret key for the meter used in forward token authentication

​
name
string
required

Display name of the meter

​
rate_type
enum<string>
required

Fee model: 'fixed' (fixed added cost) or 'percentage' (percentage of base cost)

Available options:
fixed,
percentage
​
token_basis
enum<string>
required

Token counting method: 'input+output' or 'output' only

Available options:
input+output,
output
​
base_cost_payer
enum<string>
required

Who pays the base AI provider cost

Available options:
merchant,
wallet
​
service_charge_payer
enum<string>
required

Who pays the Lava service charge

Available options:
merchant,
wallet
​
tiers
object[]
required

Pricing tiers for the meter

​
created_at
string<date-time>
required

When the meter was created