Obter Medidor

GET

meters

{id}

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const meter = await client.meters.retrieve('mtr_h5tgTWL55OyMO0L2Q9w9v');

console.log(meter.id);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
meter = client.meters.retrieve(
    id="mtr_h5tgTWL55OyMO0L2Q9w9v",
)
print(meter.id)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	meter, err := client.Meters.Get(
		context.TODO(),
		"mtr_h5tgTWL55OyMO0L2Q9w9v",
		dodopayments.MeterGetParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", meter.ID)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.meters.Meter;
import com.dodopayments.api.models.meters.MeterRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        Meter meter = client.meters().retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v");
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.meters.Meter
import com.dodopayments.api.models.meters.MeterRetrieveParams

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val meter: Meter = client.meters().retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v")
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

meter = dodo_payments.meters.retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v")

puts(meter)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $meter = $client->meters->retrieve(
    'mtr_h5tgTWL55OyMO0L2Q9w9v', locale: 'locale'
  );

  var_dump($meter);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Meters;

DodoPaymentsClient client = new();

MeterRetrieveParams parameters = new() { ID = "mtr_h5tgTWL55OyMO0L2Q9w9v" };

var meter = await client.Meters.Retrieve(parameters);

Console.WriteLine(meter);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let id = "id";
    let result = client
        .meters()
        .retrieve()
        .id(id)
        .query(serde_json::json!({}))
        .await?;
    println!("{result:?}");
    Ok(())
}

{
  "aggregation": {
    "type": "count",
    "key": "<string>"
  },
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "event_name": "<string>",
  "id": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "filter": {
    "clauses": [
      {
        "key": "user_id",
        "operator": "equals",
        "value": "user123"
      },
      {
        "key": "amount",
        "operator": "greater_than",
        "value": 100
      }
    ],
    "conjunction": "and"
  }
}

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

string

obrigatório

Meter ID

Parâmetros de consulta

locale

string

Shows the translated name, description and unit of the catalog entities in this locale. The value must be a code from GET /locales, for example fr. A field with no translation, an unknown code, or no code shows the base text.

Do not send a text from a localized response back in a create or update request. The base text then changes to the translated text.

Resposta

Meter details

aggregation

Meter Aggregation · object

obrigatório

Show child attributes

business_id

string

obrigatório

created_at

string<date-time>

obrigatório

event_name

string

obrigatório

string

obrigatório

measurement_unit

string

obrigatório

name

string

obrigatório

updated_at

string<date-time>

obrigatório

description

string | null

filter

null | Meter Filter · object

A filter structure that combines multiple conditions with logical conjunctions (AND/OR).

Supports up to 3 levels of nesting to create complex filter expressions. Each filter has a conjunction (and/or) and clauses that can be either direct conditions or nested filters.

Show child attributes

Exemplo:

{
  "clauses": [
    {
      "key": "user_id",
      "operator": "equals",
      "value": "user123"
    },
    {
      "key": "amount",
      "operator": "greater_than",
      "value": 100
    }
  ],
  "conjunction": "and"
}

Última modificação em 1 de abril de 2026

JavaScript

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'], // This is the default and can be omitted
});

const meter = await client.meters.retrieve('mtr_h5tgTWL55OyMO0L2Q9w9v');

console.log(meter.id);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
)
meter = client.meters.retrieve(
    id="mtr_h5tgTWL55OyMO0L2Q9w9v",
)
print(meter.id)

package main

import (
	"context"
	"fmt"

	"github.com/dodopayments/dodopayments-go"
	"github.com/dodopayments/dodopayments-go/option"
)

func main() {
	client := dodopayments.NewClient(
		option.WithBearerToken("My Bearer Token"),
	)
	meter, err := client.Meters.Get(
		context.TODO(),
		"mtr_h5tgTWL55OyMO0L2Q9w9v",
		dodopayments.MeterGetParams{},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", meter.ID)
}

package com.dodopayments.api.example;

import com.dodopayments.api.client.DodoPaymentsClient;
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient;
import com.dodopayments.api.models.meters.Meter;
import com.dodopayments.api.models.meters.MeterRetrieveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv();

        Meter meter = client.meters().retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v");
    }
}

package com.dodopayments.api.example

import com.dodopayments.api.client.DodoPaymentsClient
import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient
import com.dodopayments.api.models.meters.Meter
import com.dodopayments.api.models.meters.MeterRetrieveParams

fun main() {
    val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv()

    val meter: Meter = client.meters().retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v")
}

require "dodopayments"

dodo_payments = Dodopayments::Client.new(
  bearer_token: "My Bearer Token",
  environment: "test_mode" # defaults to "live_mode"
)

meter = dodo_payments.meters.retrieve("mtr_h5tgTWL55OyMO0L2Q9w9v")

puts(meter)

<?php

require_once dirname(__DIR__) . '/vendor/autoload.php';

use Dodopayments\Client;
use Dodopayments\Core\Exceptions\APIException;

$client = new Client(
  bearerToken: getenv('DODO_PAYMENTS_API_KEY') ?: 'My Bearer Token',
  environment: 'test_mode',
);

try {
  $meter = $client->meters->retrieve(
    'mtr_h5tgTWL55OyMO0L2Q9w9v', locale: 'locale'
  );

  var_dump($meter);
} catch (APIException $e) {
  echo $e->getMessage();
}

using System;
using DodoPayments.Client;
using DodoPayments.Client.Models.Meters;

DodoPaymentsClient client = new();

MeterRetrieveParams parameters = new() { ID = "mtr_h5tgTWL55OyMO0L2Q9w9v" };

var meter = await client.Meters.Retrieve(parameters);

Console.WriteLine(meter);

use dodopayments::Client;

#[tokio::main]
async fn main() -> dodopayments::Result<()> {
    let client = Client::from_env()?;
    let id = "id";
    let result = client
        .meters()
        .retrieve()
        .id(id)
        .query(serde_json::json!({}))
        .await?;
    println!("{result:?}");
    Ok(())
}

{
  "aggregation": {
    "type": "count",
    "key": "<string>"
  },
  "business_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "event_name": "<string>",
  "id": "<string>",
  "measurement_unit": "<string>",
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "filter": {
    "clauses": [
      {
        "key": "user_id",
        "operator": "equals",
        "value": "user123"
      },
      {
        "key": "amount",
        "operator": "greater_than",
        "value": 100
      }
    ],
    "conjunction": "and"
  }
}

API Reference

Checkout Sessions

Payments

Subscriptions

Discounts

Licenses

Entitlements

Customers

Customer Wallets

Products

Localized Pricing

Addons

Credit Entitlements

Meters

Usage Events

Refunds

Disputes

Payouts

Balance Ledger

Moderation

Brands

Webhooks

Miscellaneous

Product Collections

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta