---
title: Usage
description: Retrieve usage metrics and cardinality data for an InfluxDB 3 Cloud Serverless organization.
url: https://docs.influxdata.com/influxdb3/cloud-serverless/api/usage/
estimated_tokens: 423
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-serverless/api/usage/
---

[Download InfluxDB Cloud Serverless API Spec](/openapi/influxdb-cloud-serverless-api.yml)

Retrieve usage metrics and cardinality data for an InfluxDB 3 Cloud Serverless organization.

GET`/api/v2/orgs/{orgID}/usage`

### Retrieve usage for an organization

#### Parameters

##### Path parameters

`orgID`requiredstring

The ID of the organization.

##### Query parameters

`start`requiredinteger \<unix timestamp\>

Earliest time ([unix timestamp format](/influxdb3/cloud-serverless/reference/glossary/#unix-timestamp)) to include in results.

`stop`integer \<unix timestamp\>

Latest time ([unix timestamp format](/influxdb3/cloud-serverless/reference/glossary/#unix-timestamp)) to include in results.

`raw`boolean

return raw usage data

Example request[Ask AI about this](#)

```sh
curl --request GET \
  "https://us-east-1-1.aws.cloud2.influxdata.com/api/v2/orgs/{orgID}/usage?start=START" \
  --header "Authorization: Bearer INFLUX_TOKEN"
```

#### Responses

200Usage data

defaultNon 2XX error response from server.

`code`requiredstring

code is the machine-readable error code.

Allowed:`internal error`, `not implemented`, `not found`, `conflict`, `invalid`, `unprocessable entity`, `empty value`, `unavailable`, `forbidden`, `too many requests`, `unauthorized`, `method not allowed`, `request too large`, `unsupported media type`

`err`string

Stack of errors that occurred during processing of the request. Useful for debugging.

`message`string

Human-readable message.

`op`string

Describes the logical code operation when the error occurred. Useful for debugging.

#### Related

* [InfluxDB 3 API client libraries](/influxdb3/cloud-serverless/reference/client-libraries/v3/)