---
title: "List billing accounts"
method: GET
path: "/ads-management/v1/billing-accounts"
tags: ["Advertising"]
---

# List billing accounts

`GET /ads-management/v1/billing-accounts`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/billing-accounts`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

Lists the billing accounts owned by the authenticated user. Each account includes its type, status, time zone, and create/update timestamps. Results are paginated with a cursor (pageToken).

## Query parameters

- `maxPageSize` integer
- `pageToken` string

## Response `200`

OK

- InternalPublicV1ListBillingAccountsResponse
  - `billingAccounts` InternalPublicV1BillingAccount[]: The page of billing accounts.
    - `createTime` string: The time the account was created, as an RFC 3339 UTC timestamp.
    - `displayName` string: The human-readable name of the account.
    - `id` string: The unique identifier of the billing account. Use it as the {id} path parameter.
    - `organizationId` string: The identifier of the organization that owns the account.
    - `status` 'ACTIVE' | 'DISABLED' | 'ARCHIVED': The current state of the account. Can be `ACTIVE`, `DISABLED`, or `ARCHIVED`.
    - `timeZone` string: The IANA time zone the account's reporting dates and budget schedules are interpreted in. Example: `America/Los_Angeles`.
    - `type` 'SELF_SERVICE' | 'MANAGED' | 'INTERNAL': The account category. External advertisers are always SELF_SERVICE; MANAGED and INTERNAL are Roblox-operated accounts. Can be `SELF_SERVICE`, `MANAGED`, or `INTERNAL`.
    - `updateTime` string: The time the account was last updated, as an RFC 3339 UTC timestamp.
  - `nextPageToken` string: The cursor for the next page. Pass it as pageToken to fetch the next page. Absent on the last page.

## Other responses

- `400`: Invalid maxPageSize or pageToken
- `403`: Permission denied
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-10-14** `5dcfa33df56a`: 1 info
  - the endpoint scheme security `roblox-oauth2` was removed from the API
- **2026-08-25** `a04d95d4c604`: 1 info
  - the endpoint scheme security `roblox-legacy-cookie` was added to the API

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/billing-accounts/get.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/bcfdc20689cd?raw)