List Meter Prices | PaymentKit

curl https://app.paymentkit.com/api/account_id/meters/meter_id/prices \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "items": [
    {
      "id": "price_8f3b2c1d",
      "account_id": "acct_9a7d4e2f",
      "product_id": "prod_4b6e8a9c",
      "name": "Residential Monthly Rate",
      "unit_amount_atom": 1500,
      "currency": "usd",
      "is_active": true,
      "unit_label": "kWh",
      "pricing_type": "tiered",
      "recurring_interval": "month",
      "recurring_interval_count": 1,
      "auto_renew": true,
      "contract_term_multiple": 12,
      "trial_days": 0,
      "usage_type": "metered",
      "metered_id": "meter_12345",
      "billing_scheme": "per_unit",
      "tier_amount_info": {
        "mode": "graduated",
        "amount_atoms": [
          {
            "unit_amount_atom": 1200,
            "units_upto": 100,
            "flat_amount_atom": 0
          },
          {
            "unit_amount_atom": 1000,
            "units_upto": 500,
            "flat_amount_atom": 0
          },
          {
            "unit_amount_atom": 800,
            "flat_amount_atom": 0
          }
        ]
      },
      "prerequisite_price_ids": [
        "price_7d2a1b3c"
      ],
      "exclusive_customer_ids": [
        "cust_00123"
      ],
      "metadata": {
        "region": "northwest",
        "plan_type": "residential"
      },
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-10T12:00:00Z",
      "product_name": "Standard Electricity Plan",
      "product_description": "Monthly electricity usage pricing for residential customers",
      "custom_fields": {
        "support_contact": "support@electricco.com",
        "notes": "Includes renewable energy surcharge"
      },
      "quantity_divisor": 1
    }
  ],
  "total": 1,
  "has_more": false
}

List prices associated with this meter.

Authentication

AuthorizationBearer

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

Path parameters

meter_idstringRequired

account_idstringRequired

Query parameters

limitintegerOptional1-100Defaults to 50

Number of items per page

offsetintegerOptional>=0Defaults to 0

Number of items to skip

filterstringOptionalDefaults to {}

Filter conditions as key-value pairs or advanced filter objects (JSON string)

sortBystring or nullOptional

Field to sort by

sortOrderintegerOptionalDefaults to -1

Sort order: 1 for ascending, -1 for descending

searchstring or nullOptional

Keyword-based search across multiple fields

Response

Successful Response

itemslist of objects

totalinteger

has_moreboolean

Authentication

Path parameters

Query parameters

Response

Errors