Retrieve billing information with Viam's Billing Client API

The billing client API allows you to retrieve billing information from the Viam app.

Establish a connection

To use the Viam billing client API, you first need to instantiate a ViamClient and then instantiate a BillingClient.

You will also need an API key and API key ID to authenticate your session. Your API key needs to have Org owner permissions to use the billing client API. To get an API key (and corresponding ID), you have two options:

• Create an API key using the Viam app
• Create an API key using the Viam CLI

The following example instantiates a ViamClient, authenticating with an API key, and then instantiates a BillingClient:

import asyncio

from viam.rpc.dial import DialOptions, Credentials
from viam.app.viam_client import ViamClient
from viam.app.billing_client import BillingClient


async def connect() -> ViamClient:
    dial_options = DialOptions(
      credentials=Credentials(
        type="api-key",
        # Replace "<API-KEY>" (including brackets) with your machine's API key
        payload='<API-KEY>',
      ),
      # Replace "<API-KEY-ID>" (including brackets) with your machine's
      # API key ID
      auth_entity='<API-KEY-ID>'
    )
    return await ViamClient.create_from_dial_options(dial_options)


async def main():
    # Make a ViamClient
    viam_client = await connect()
    # Instantiate a BillingClient to run data client API methods on
    billing_client = viam_client.billing_client

    viam_client.close()

if __name__ == '__main__':
    asyncio.run(main())

Once you have instantiated a BillingClient, you can run API methods against the BillingClient object (named billing_client in the examples).

API

The billing client API supports the following methods:

GetCurrentMonthUsage

Access data usage information for the current month for a given organization. You can also find your usage data on the Payment and billing page.

usage = await viam_client.billing_client.get_current_month_usage("<ORG-ID>")

GetInvoicePdf

Access invoice PDF data and optionally save it to a provided file path. You can also find your invoices on the Payment and billing page.

await viam_client.billing_client.get_invoice_pdf(
    "<INVOICE-ID>", "<ORG-ID>", "<FILENAME>")

GetInvoicesSummary

Access total outstanding balance plus invoice summaries for a given org.

summary = await viam_client.billing_client.get_invoices_summary("<ORG-ID>")

GetOrgBillingInformation

Access billing information (payment method, billing tier, etc.) for a given org. You can also find this information on the Payment and billing page.

information = await viam_client.billing_client.get_org_billing_information(
    "<ORG-ID>")