---
title: "Quote a metered X action"
method: POST
path: "/api/v1/billing/billable-usage/quote"
tags: ["credit"]
---

# Quote a metered X action

`POST /api/v1/billing/billable-usage/quote`

## Request

- Base URL: `https://api.bundle.social`
- URL: `https://api.bundle.social/api/v1/billing/billable-usage/quote`
- Auth: API key in header `x-api-key`

Estimate the credit cost of a metered X action (post publishing, analytics reads, imports) before running it, and see whether your current balance covers it.

## Request body

- object
  - `teamId` string, required
  - `text` string
  - `texts` string[]
  - `action` 'TWITTER_CONTENT_CREATE' | 'TWITTER_CONTENT_CREATE_WITH_URL' | 'TWITTER_CONTENT_MANAGE' | 'TWITTER_INTERACTION_DELETE' | 'TWITTER_POST_READ' | 'TWITTER_USER_READ' | 'TWITTER_USER_INTERACTION_CREATE'
  - `altTextCount` integer
  - `quantity` integer

## Response `200`

200

- object
  - `billable` boolean, required
  - `lines` object[], required
    - `action` 'TWITTER_CONTENT_CREATE' | 'TWITTER_CONTENT_CREATE_WITH_URL' | 'TWITTER_CONTENT_MANAGE' | 'TWITTER_INTERACTION_DELETE' | 'TWITTER_POST_READ' | 'TWITTER_USER_READ' | 'TWITTER_USER_INTERACTION_CREATE', required
    - `label` string, required
    - `unitAmountMicros` integer, required
    - `amountMicros` integer, required
    - `amountCents` integer, required
    - `currency` 'usd', required
  - `totalMicros` integer, required
  - `totalCents` integer, required
  - `currency` 'usd', required
  - `availableMicros` integer, required
  - `availableCents` integer, required
  - `wouldExceedBalance` boolean, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429
- `500`: 500
- `502`: 502
- `503`: 503
- `504`: 504

## Changes

- **2026-11-03** `fb6e4fbd8d2f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bundle/apis/bundle-social-api/changes/api/v1/billing/billable-usage/quote/post.md)

---

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