---
title: "Get usage"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get usage

`GET /usage`

## Request

- Base URL: `https://cloud.laravel.com/api`
- URL: `https://cloud.laravel.com/api/usage`
- Auth: HTTP bearer

Get billing and usage data for the authenticated organization.

## Query parameters

- `period` integer, nullable
- `environment` string, nullable

## Response `200`

- object
  - `data` object, required
    - `summary` object, required
      - `current_spend_cents` integer, required
      - `bandwidth` object, nullable, required
        - `cost_cents` integer, required
        - `usage_percentage` integer, required
        - `allowance_bytes` integer, required
      - `credits` object, nullable, required
        - `used_cents` integer, required
        - `total_cents` integer, required
      - `alert` object, nullable, required
        - `threshold_cents` integer, required
        - `remaining_percentage` integer, required
    - `resources` object, required
      - `total_cost_cents` integer, required
      - `databases` object[], required
      - `caches` object[], required
      - `buckets` object[], required
      - `websockets` object[], required
    - `addons` object, required
      - `total_cost_cents` integer, required
      - `items` object[], required
        - `name` string, required
        - `total_cents` integer, required
    - `application_totals` object, required
      - `total_cost_cents` integer, required
      - `application_count` integer, required
      - `applications` object[], required
    - `environment_usage` object, nullable, required
      - `total_cost_cents` integer, required
      - `items` object[], required
    - `private_cloud` object, nullable, required
      - `total_cost_cents` integer, required
      - `sections` object, required
      - `instances` object, required
  - `meta` object, required
    - `currency` string, required
    - `period` integer, required
    - `available_periods` object[], required
      - `from` string, nullable, required
      - `to` string, nullable, required
    - `last_updated_at` string, required

## Other responses

- `401`: An error
- `403`: Authorization error
- `422`: Validation error

---

[API](https://skmtc.dev/laravel/apis/laravel-cloud.md) - [All operations](https://skmtc.dev/laravel/apis/laravel-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/laravel/apis/laravel-cloud/revisions/af603f54ff33?raw)