---
title: "Billing State"
method: GET
path: "/v1/organizations/{organization_id}/billing"
tags: ["Billing"]
---

# Billing State

`GET /v1/organizations/{organization_id}/billing`

## Request

- Base URL: `https://api.usealmanac.com`
- URL: `https://api.usealmanac.com/v1/organizations/{organization_id}/billing`
- Auth: HTTP bearer

## Path parameters

- `organization_id` string, required

## Response `200`

Successful Response

- HostedBillingState
  - `manage` HostedBillingManage, required
    - `allowed` boolean, required
    - `reason` 'permission' | 'not_allowed', required
  - `organization_id` string, required
  - `plans` HostedBillingPlan[], required
    - `action` 'activate' | 'upgrade' | 'downgrade' | 'purchase' | 'none'
    - `features` HostedPlanFeature[]
      - `feature_id` string, required
      - `included` number, nullable
    - `group` string, nullable
    - `interval` string, nullable
    - `name` string, required
    - `plan_id` string, required
    - `price` number, nullable
    - `status` 'active' | 'scheduled'
  - `subscription` HostedBillingSubscription, required
    - `current_period_end` number, nullable
    - `ends_at` number, nullable
    - `plan_id` string, nullable
    - `state` 'inactive' | 'legacy_free' | 'trialing' | 'active' | 'ending' | 'past_due', required
    - `trial_available` boolean
    - `trial_ends_at` number, nullable
  - `usage` HostedBillingUsage[]
    - `feature_id` string, required
    - `granted` number, required
    - `next_reset_at` number, nullable
    - `overage_allowed` boolean
    - `remaining` number, required
    - `unlimited` boolean
    - `usage` number, required

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/usealmanac/apis/almanac-v1-api.md) - [All operations](https://skmtc.dev/usealmanac/apis/almanac-v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usealmanac/apis/almanac-v1-api/revisions/2874ff06ed74?raw)