---
title: "Get current billing state"
method: GET
path: "/billing/me"
tags: ["Billing"]
---

# Get current billing state

`GET /billing/me`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/billing/me`
- Auth: API key in header `x-api-key`

Returns the authenticated user's current billing plan, period, included credits, used credits, remaining credits, overage status, and any downgrade scheduled for the next renewal.

## Headers

- `x-api-key` string, required

## Response `200`

Current billing state

- BillingBillingStateResponseDoc
  - `code` integer
  - `data` BillingBillingStateDoc
    - `allow_overage` boolean
    - `created_at` string
    - `credits_remaining` integer
    - `credits_used` integer
    - `currency` string
    - `daily_credit_limit` integer
    - `daily_credits_remaining` integer
    - `daily_credits_used` integer
    - `daily_key` string
    - `expected_subscription_amount_cents` integer
    - `expected_total_amount_cents` integer
    - `hard_limit` boolean
    - `included_credits` integer
    - `overage_credits` integer
    - `pending_plan` string
    - `pending_plan_effective_at` string
    - `period_end` string
    - `period_key` string
    - `period_start` string
    - `plan` string
    - `pricing_source` string
    - `subscription_price_cents` integer
    - `updated_at` string
    - `user_id` string
  - `msg` string

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

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