---
title: "X API usage for the organization"
method: GET
path: "/api/v1/usage/x"
tags: ["Usage"]
---

# X API usage for the organization

`GET /api/v1/usage/x`

## Request

- Base URL: `https://app.tryadeli.com`
- URL: `https://app.tryadeli.com/api/v1/usage/x`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/adeli/apis/adeli-api/docs/api/v1/usage/x/get.ts> (a function with typed inputs; its response is checked against the schema)

X API fees are passed through at X's published rates; this totals the organization's usage.

## Response `200`

Success

- object
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `ratesAsOf` string, required
  - `totalCostMicros` number, required
  - `operations` object[], required
    - `operation` string, required
    - `resourceType` string, required
    - `resourceCount` number, required
    - `costMicros` number, required

## Other responses

- `400`: Invalid request or provider failure
- `401`: Missing or invalid API key
- `402`: Billing is required: a card is needed to connect more accounts or use X (`billing_required`, `x_billing_required`), or the workspace has used its free monthly allowance (`usage_limit_reached`)
- `404`: Profile, account, or object not found
- `429`: Provider quota or rate limit exhausted
- `502`: Invalid request or provider failure

---

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