---
type: api
title: Get the usage charts for the organization.
description: Retrieves the usage charts for the organization.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-billing/operation/operation-getchartsv2
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-billing/operation/operation-getchartsv2
products:
  - Elastic Cloud Hosted
---

# Get the usage charts for the organization.

- Server: `https://cloud.elastic.co` (Public)

## Paths

- `GET` `/api/v2/billing/organizations/{organization_id}/charts`

#### Path Parameters

- `organization_id` (string)

## Description

Retrieves the usage charts for the organization.
Admin callers receive all instances; non-admin user callers receive
data filtered to the instances they have access to (empty buckets if
none).

## Query String Parameters

- `from` (string)
  A datetime for the beginning of the desired range. Non-UTC offsets are converted to UTC internally. Responses always contain UTC values. If no timezone offset is specified, the request is rejected.
- `to` (string)
  A datetime for the end of the desired range. Non-UTC offsets are converted to UTC internally. Responses always contain UTC values. If no timezone offset is specified, the request is rejected.
- `bucketing_strategy` (enum)
  The desired bucketing strategy for the charts.
  Values: `daily`, `monthly`

## Responses

#### `200`

Successfully return the usage charts of an organization.

`application/json`

- `data` ([] object)
  The list of chart item.
  - `timestamp` (integer)
    Axis X position.
  - `values` ([] object)
    The collection of values to plot the chart item.
    - `id` (string)
      The id of chart item value.
    - `name` (string)
      The name of the chart item value.
    - `type` (string)
      Item type.
    - `value` (number)
      The actual value of the chart item value.
#### `401`

Unauthorized

`text/plain`

Type: `string`

#### `404`

Not found.

#### `424`

Failed dependency.

#### `500`

Internal Server Error.

## Code Examples

#### Console

```console
GET /api/v2/billing/organizations/{organization_id}/charts?from={from}&to={to}
```

#### curl

```curl
curl -X GET "https://cloud.elastic.co/api/v2/billing/organizations/{organization_id}/charts?from={from}&to={to}"
```