---
title: "Get monthly billing period usage and upgrade recommendations"
method: GET
path: "/api/v1/usage/monthly"
tags: ["Usage"]
---

# Get monthly billing period usage and upgrade recommendations

`GET /api/v1/usage/monthly`

## Request

- Base URL: `https://api.tuteliq.ai`
- URL: `https://api.tuteliq.ai/api/v1/usage/monthly`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns your current billing period usage (calls used vs. limit), tier details, rate limits, and days remaining. Includes smart upgrade recommendations when you approach 80% usage or have fewer than 200 calls remaining. Links to dashboard, pricing, and credit purchase pages.

## Response `200`

Default Response

- object
  - `tier` string
  - `tier_display_name` string
  - `billing` object
    - `current_period_start` string
    - `current_period_end` string
    - `days_remaining` number
  - `usage` object
    - `used` number
    - `limit` number
    - `remaining` number
    - `percent_used` number
  - `rate_limit` object
    - `requests_per_minute` number
  - `recommendations` object, nullable
    - `should_upgrade` boolean
    - `reason` string
    - `suggested_tier` string
    - `upgrade_url` string
  - `links` object
    - `dashboard` string
    - `pricing` string
    - `buy_credits` string

---

[API](https://skmtc.dev/tuteliq/apis/tuteliq-api.md) · [All operations](https://skmtc.dev/tuteliq/apis/tuteliq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tuteliq/apis/tuteliq-api/revisions/8490332e0031?raw)