---
title: "Get usage & estimated charge"
method: GET
path: "/api/v1/functions/usage"
tags: ["Functions"]
---

# Get usage & estimated charge

`GET /api/v1/functions/usage`

Current calendar-month usage across the account's two paid meters
(memory GB-seconds and active-CPU vCPU-seconds), the monthly free
tier remaining, AI Lambda-conversions used, and the estimated charge
month-to-date (only usage beyond the free tier bills). Requests and
egress are free and never metered for billing.

## Query parameters

- `function_id` string

## Response `200`

Usage summary

- object
  - `success` boolean
  - `data` FunctionsUsage
    - `memory_gb_seconds` number
    - `warm_gb_seconds` number
    - `cpu_seconds` number
    - `request_count` integer — Informational — requests are free
    - `free_gb_seconds_remaining` number
    - `free_vcpu_seconds_remaining` number
    - `estimated_cost_usd` number — Month-to-date, after the free tier
    - `ai_conversions` integer — AI Lambda-rewrites used this calendar month
    - `period_start` string, date-time
    - `period_end` string, date-time
    - `as_of` string, date-time — Metering watermark (near-real-time)

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)