---
title: "Preview a Robux-to-ad-credit conversion"
method: POST
path: "/ads-management/v1/billing-accounts/{id}/ad-credit-conversions:preview"
---

# Preview a Robux-to-ad-credit conversion

`POST /ads-management/v1/billing-accounts/{id}/ad-credit-conversions:preview`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/billing-accounts/{id}/ad-credit-conversions:preview`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

Calculates the other side of a conversion from either a Robux amount or an ad credit amount, using the account's current Robux balances and rates. An amount the account cannot afford or outside the allowed range returns 200 with valid=false and a reason.

## Path parameters

- `id` string, required

## Request body

- PreviewAdCreditConversionRequest
  - `adCreditAmountMicros` string: Ad credit wanted, at most cent precision; the preview returns the Robux it costs.
  - `robuxAmount` string: Robux to spend; the preview returns the ad credit it buys.

## Response `200`

OK

- AdCreditConversionPreview
  - `adCreditAmountMicros` string, required: Ad credit that would be granted, in micro-USD.
  - `effectiveO18Robux` string: Portion of robuxAmount drawn from 18+ eligible Robux, which converts at the higher rate first.
  - `effectiveStandardRobux` string: Portion of robuxAmount drawn from standard Robux.
  - `reason` Reason
    - `code` string, required: A stable, machine-readable code.
    - `message` string, required: A human-readable explanation.
    - `remediation` string: What the caller can do to resolve it.
    - `resource` string: The related resource, for example `billing-accounts/123`.
  - `robuxAmount` string, required: Robux that would be charged.
  - `tierBreakdown` AdCreditConversionTierBreakdown[]: One entry per rate tier used, in the order Robux are drawn.
    - `adCreditAmountMicros` string, required: Ad credit granted from this tier, in micro-USD.
    - `adCreditPerRobux` number, double, required: USD of ad credit per Robux in this tier.
    - `robuxAmount` string, required: Robux converted in this tier.
    - `tier` 'O18_ELIGIBLE_ROBUX' | 'STANDARD_ROBUX', required: Rate tier (`O18_ELIGIBLE_ROBUX` or `STANDARD_ROBUX`).
  - `valid` boolean, required: False when the account can't afford the amount or it's outside the allowed range.

## Other responses

- `400`: Validation error
- `403`: Permission denied
- `404`: Billing account not found
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/billing-accounts/:id/ad-credit-conversions:preview/post.md)

---

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