Retrieve current usage

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
EXTERNAL_CUSTOMER_ID="__EXTERNAL_CUSTOMER_ID__"
EXTERNAL_SUBSCRIPTION_ID="__EXTERNAL_SUBSCRIPTION_ID__"

curl --location --request GET "$LAGO_URL/api/v1/customers/$EXTERNAL_CUSTOMER_ID/current_usage?external_subscription_id=$EXTERNAL_SUBSCRIPTION_ID" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError

client = Client(api_key='__YOUR_API_KEY__')

customer_usage = None
try:
    customer_usage = client.customers.current_usage('external_customer_id', 'external_subscription_id')
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
customer_usage = client.customer.current_usage(
  'external_customer_id', 'external_subscription_id'
)

await client.customers.findCustomerCurrentUsage(
  "customer_external_id",
  { external_subscription_id: "external_subscription_id" }
);

  import "fmt"
  import "github.com/getlago/lago-go-client"

  func main() {
    lagoClient := lago.New().
      SetApiKey("__YOUR_API_KEY__")

    customerUsage, err := lagoClient.Customer().CurrentUsage("__YOUR_CUSTOMER_ID__")
    if err != nil {
      // Error is *lago.Error
      panic(err)
    }

    // customerUsage is *lago.CustomerUsage
    fmt.Println(customerUsage)
  }

{
  "customer_usage": {
    "from_datetime": "2022-07-01T00:00:00Z",
    "to_datetime": "2022-07-31T23:59:59Z",
    "issuing_date": "2022-08-01",
    "amount_cents": 123,
    "taxes_amount_cents": 200,
    "total_amount_cents": 123,
    "charges_usage": [
      {
        "units": "1.0",
        "total_aggregated_units": "1.0",
        "events_count": 10,
        "amount_cents": 123,
        "amount_currency": "EUR",
        "charge": {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "charge_model": "graduated",
          "invoice_display_name": "Setup"
        },
        "billable_metric": {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "name": "Storage",
          "code": "storage",
          "aggregation_type": "sum_agg"
        },
        "pricing_unit_details": {
          "amount_cents": 200,
          "short_name": "CR",
          "conversion_rate": "0.5"
        },
        "filters": [
          {
            "units": "0.9",
            "total_aggregated_units": "1.0",
            "amount_cents": 1000,
            "events_count": 10,
            "invoice_display_name": "AWS eu-east-1",
            "pricing_unit_details": {
              "amount_cents": 200,
              "short_name": "CR",
              "conversion_rate": "0.5"
            },
            "values": {
              "region": [
                "us-east-1"
              ]
            },
            "presentation_breakdowns": [
              {
                "presentation_by": {},
                "units": "9.0"
              }
            ]
          }
        ],
        "grouped_usage": [
          {
            "amount_cents": 1000,
            "events_count": 10,
            "units": "0.9",
            "total_aggregated_units": "1.0",
            "pricing_unit_details": {
              "amount_cents": 200,
              "short_name": "CR",
              "conversion_rate": "0.5"
            },
            "grouped_by": {},
            "filters": [
              {
                "units": "0.9",
                "total_aggregated_units": "1.0",
                "amount_cents": 1000,
                "events_count": 10,
                "invoice_display_name": "AWS eu-east-1",
                "pricing_unit_details": {
                  "amount_cents": 200,
                  "short_name": "CR",
                  "conversion_rate": "0.5"
                },
                "values": {
                  "region": [
                    "us-east-1"
                  ]
                },
                "presentation_breakdowns": [
                  {
                    "presentation_by": {},
                    "units": "9.0"
                  }
                ]
              }
            ],
            "presentation_breakdowns": [
              {
                "presentation_by": {},
                "units": "9.0"
              }
            ]
          }
        ],
        "presentation_breakdowns": [
          {
            "presentation_by": {},
            "units": "9.0"
          }
        ]
      }
    ],
    "lago_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "currency": "EUR"
  }
}

{
  "status": 401,
  "error": "Unauthorized"
}

{
  "status": 404,
  "error": "Not Found",
  "code": "object_not_found"
}

GET

customers

{external_customer_id}

current_usage

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
EXTERNAL_CUSTOMER_ID="__EXTERNAL_CUSTOMER_ID__"
EXTERNAL_SUBSCRIPTION_ID="__EXTERNAL_SUBSCRIPTION_ID__"

curl --location --request GET "$LAGO_URL/api/v1/customers/$EXTERNAL_CUSTOMER_ID/current_usage?external_subscription_id=$EXTERNAL_SUBSCRIPTION_ID" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError

client = Client(api_key='__YOUR_API_KEY__')

customer_usage = None
try:
    customer_usage = client.customers.current_usage('external_customer_id', 'external_subscription_id')
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
customer_usage = client.customer.current_usage(
  'external_customer_id', 'external_subscription_id'
)

await client.customers.findCustomerCurrentUsage(
  "customer_external_id",
  { external_subscription_id: "external_subscription_id" }
);

  import "fmt"
  import "github.com/getlago/lago-go-client"

  func main() {
    lagoClient := lago.New().
      SetApiKey("__YOUR_API_KEY__")

    customerUsage, err := lagoClient.Customer().CurrentUsage("__YOUR_CUSTOMER_ID__")
    if err != nil {
      // Error is *lago.Error
      panic(err)
    }

    // customerUsage is *lago.CustomerUsage
    fmt.Println(customerUsage)
  }

{
  "customer_usage": {
    "from_datetime": "2022-07-01T00:00:00Z",
    "to_datetime": "2022-07-31T23:59:59Z",
    "issuing_date": "2022-08-01",
    "amount_cents": 123,
    "taxes_amount_cents": 200,
    "total_amount_cents": 123,
    "charges_usage": [
      {
        "units": "1.0",
        "total_aggregated_units": "1.0",
        "events_count": 10,
        "amount_cents": 123,
        "amount_currency": "EUR",
        "charge": {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "charge_model": "graduated",
          "invoice_display_name": "Setup"
        },
        "billable_metric": {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "name": "Storage",
          "code": "storage",
          "aggregation_type": "sum_agg"
        },
        "pricing_unit_details": {
          "amount_cents": 200,
          "short_name": "CR",
          "conversion_rate": "0.5"
        },
        "filters": [
          {
            "units": "0.9",
            "total_aggregated_units": "1.0",
            "amount_cents": 1000,
            "events_count": 10,
            "invoice_display_name": "AWS eu-east-1",
            "pricing_unit_details": {
              "amount_cents": 200,
              "short_name": "CR",
              "conversion_rate": "0.5"
            },
            "values": {
              "region": [
                "us-east-1"
              ]
            },
            "presentation_breakdowns": [
              {
                "presentation_by": {},
                "units": "9.0"
              }
            ]
          }
        ],
        "grouped_usage": [
          {
            "amount_cents": 1000,
            "events_count": 10,
            "units": "0.9",
            "total_aggregated_units": "1.0",
            "pricing_unit_details": {
              "amount_cents": 200,
              "short_name": "CR",
              "conversion_rate": "0.5"
            },
            "grouped_by": {},
            "filters": [
              {
                "units": "0.9",
                "total_aggregated_units": "1.0",
                "amount_cents": 1000,
                "events_count": 10,
                "invoice_display_name": "AWS eu-east-1",
                "pricing_unit_details": {
                  "amount_cents": 200,
                  "short_name": "CR",
                  "conversion_rate": "0.5"
                },
                "values": {
                  "region": [
                    "us-east-1"
                  ]
                },
                "presentation_breakdowns": [
                  {
                    "presentation_by": {},
                    "units": "9.0"
                  }
                ]
              }
            ],
            "presentation_breakdowns": [
              {
                "presentation_by": {},
                "units": "9.0"
              }
            ]
          }
        ],
        "presentation_breakdowns": [
          {
            "presentation_by": {},
            "units": "9.0"
          }
        ]
      }
    ],
    "lago_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "currency": "EUR"
  }
}

{
  "status": 401,
  "error": "Unauthorized"
}

{
  "status": 404,
  "error": "Not Found",
  "code": "object_not_found"
}

LAGO_URL="https://api.getlago.com"
API_KEY="__YOUR_API_KEY__"
EXTERNAL_CUSTOMER_ID="__EXTERNAL_CUSTOMER_ID__"
EXTERNAL_SUBSCRIPTION_ID="__EXTERNAL_SUBSCRIPTION_ID__"

curl --location --request GET "$LAGO_URL/api/v1/customers/$EXTERNAL_CUSTOMER_ID/current_usage?external_subscription_id=$EXTERNAL_SUBSCRIPTION_ID" \
--header "Authorization: Bearer $API_KEY" \
--header 'Content-Type: application/json'

from lago_python_client.client import Client
from lago_python_client.exceptions import LagoApiError

client = Client(api_key='__YOUR_API_KEY__')

customer_usage = None
try:
    customer_usage = client.customers.current_usage('external_customer_id', 'external_subscription_id')
except LagoApiError as e:
    repair_broken_state(e)  # do something on error or raise your own exception

require 'lago-ruby-client'

client = Lago::Api::Client.new(api_key: '__YOUR_API_KEY__')
customer_usage = client.customer.current_usage(
  'external_customer_id', 'external_subscription_id'
)

await client.customers.findCustomerCurrentUsage(
  "customer_external_id",
  { external_subscription_id: "external_subscription_id" }
);

  import "fmt"
  import "github.com/getlago/lago-go-client"

  func main() {
    lagoClient := lago.New().
      SetApiKey("__YOUR_API_KEY__")

    customerUsage, err := lagoClient.Customer().CurrentUsage("__YOUR_CUSTOMER_ID__")
    if err != nil {
      // Error is *lago.Error
      panic(err)
    }

    // customerUsage is *lago.CustomerUsage
    fmt.Println(customerUsage)
  }

Authorizations

Authorization

string

header

required

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

Path Parameters

external_customer_id

string

required

The customer external unique identifier (provided by your own application).

Example:

"5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba"

Query Parameters

external_subscription_id

string

required

The unique identifier of the subscription within your application.

Example:

"sub_1234567890"

apply_taxes

boolean

default:true

Optional flag to determine if taxes should be applied. Defaults to true if not provided or if null.

Example:

true

charge_id

string<uuid>

Filter usage to a specific charge by its Lago ID (UUID). Replaces deprecated filter_by_charge_id.

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

charge_code

string

Filter usage to a specific charge by its code. Replaces deprecated filter_by_charge_code.

Example:

"storage"

billable_metric_code

string

Filter usage to a specific billable metric by its code.

Example:

"storage"

group

object

Filter usage by pricing group. Pass key/value pairs as query parameters, e.g. group[cloud]=aws. Replaces deprecated filter_by_group.

Show child attributes

Example:

{ "cloud": "aws" }

filter_by_charge_id

string<uuid>

Deprecated. Filter usage to a specific charge by its Lago ID (UUID).

Example:

"1a901a90-1a90-1a90-1a90-1a901a901a90"

filter_by_charge_code

string

Deprecated. Filter usage to a specific charge by its code.

Example:

"storage"

filter_by_group

object

Deprecated. Filter usage by pricing group. Pass key/value pairs as query parameters, e.g. filter_by_group[cloud]=aws.

Show child attributes

Example:

{ "cloud": "aws" }

full_usage

boolean

default:false

When true, returns usage since subscription start instead of the current billing period. Requires one of charge_id, charge_code, group (or their deprecated filter_by_* equivalents) to be set.

Example:

true

filter_by_presentation

string

Filter presentation_breakdowns by a JSON-encoded array of presentation group key values. Only breakdowns matching the provided values will be returned. Pass an empty array to disable presentation_breakdowns entirely.

Example:

"[\"engineering\", \"operations\"]"

Response

Customer usage

customer_usage

object

required

Show child attributes

Retrieve usages Retrieve projected usage

⌘I