---
title: "List scoped payment activity"
method: GET
path: "/ads-management/v1/billing-accounts/{id}/payment-activities"
---

# List scoped payment activity

`GET /ads-management/v1/billing-accounts/{id}/payment-activities`

## Request

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

Lists one ledger, newest first. AD_CREDIT includes the source transaction type and initiator when available. CARD charge rows include the latest associated card settlement time when available. CARD requires type=CHARGE or type=REFUND. CHARGE and AD_CREDIT use cursor pagination; filtered pages can be short or empty and still have a nextPageToken. REFUND requires startTime (inclusive) and endTime (exclusive), returns complete results without pagination, and rejects ranges containing more than 100 refund requests, including non-card requests. Requests without payment details are retained; known non-card payments are excluded.

## Path parameters

- `id` string, required

## Query parameters

- `ledger` 'CARD' | 'AD_CREDIT', required
- `type` 'CHARGE' | 'REFUND'
- `startTime` string, date-time
- `endTime` string, date-time
- `maxPageSize` integer
- `pageToken` string

## Response `200`

OK

- ListPaymentActivitiesResponse
  - `activities` PaymentActivity[], required: Payment activities for the selected scope; REFUND returns the complete time range.
    - `actorUserId` string: Roblox user who initiated the AD_CREDIT transaction, when available, for user and group accounts.
    - `adCreditTransactionType` 'DEPOSIT' | 'AUTO_DEPOSIT' | 'DEBIT' | 'REFUND' | 'ADJUSTMENT' | 'PROMOTION': Source transaction type for AD_CREDIT rows. The broader type remains available.
    - `amountMicros` string, required: Amount actually charged, refunded, granted, or spent, in micro-USD.
    - `campaignId` string: Associated campaign ID, when applicable.
    - `campaignName` string: Associated campaign name, present when campaignId is set.
    - `cardLastFourDigits` string: Last four digits of the card used (`CHARGE` and `REFUND` only).
    - `chargeTime` string, date-time: Latest associated card charge settlement timestamp as an RFC 3339 UTC string, when available (`CHARGE` only).
    - `createTime` string, date-time, required: Creation timestamp as an RFC 3339 UTC string.
    - `currencyCode` string: ISO 4217 currency of the card charge (`CHARGE` and `REFUND` only).
    - `description` string: Optional human-readable description.
    - `id` string: Stable payment identifier, when available. Absent for requests without a payment identifier.
    - `o18RobuxAmount` string: Portion of robuxAmount debited from 18+ eligible Robux (`ROBUX_CONVERSION` only).
    - `requestAmountMicros` string: Amount originally requested, in micro-USD (`CHARGE` and `REFUND` only).
    - `robuxAmount` string: Total Robux debited (`ROBUX_CONVERSION` only).
    - `state` 'PENDING' | 'SUCCEEDED' | 'FAILED' | 'REVERSED', required: The settlement state (`PENDING`, `SUCCEEDED`, `FAILED`, or `REVERSED`).
    - `type` 'CHARGE' | 'REFUND' | 'AD_CREDIT_GRANT' | 'AD_CREDIT_SPEND' | 'ROBUX_CONVERSION', required: The activity type (`CHARGE`, `REFUND`, `AD_CREDIT_GRANT`, `AD_CREDIT_SPEND`, or `ROBUX_CONVERSION`).
  - `nextPageToken` string: Opaque cursor for the next page of CHARGE or AD_CREDIT. Absent on the last page and for REFUND.

## Other responses

- `400`: Invalid scope, pagination, or time range; REFUND_WINDOW_TOO_LARGE requires a narrower range
- `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/payment-activities/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/a94d3bd77d7f?raw)
