---
title: "Operation to Get Billing Activities"
method: GET
path: "/service-efficiency-api/v1/billing_activities/groups/{groupId}"
tags: ["Accounts", "Groups", "Service Efficiency"]
---

# Operation to Get Billing Activities

`GET /service-efficiency-api/v1/billing_activities/groups/{groupId}`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/service-efficiency-api/v1/billing_activities/groups/{groupId}`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Path parameters

- `groupId` integer, required

## Query parameters

- `startYear` integer, required
- `startMonth` integer, required
- `endYear` integer, required
- `endMonth` integer, required

## Response `200`

OK

- BillingActivitiesResponse: Response object for Billing Activities request.
  - `accountState` 'Invalid' | 'Normal' | 'Overdue' | 'Suspended': Account State in the HTTP response.
  - `billSummaries` BillSummary[], nullable: Gets or sets the list of account bill summaries.
    - `timestamp` integer, required: Gets or sets the year of this bill.
    - `billId` string, nullable: Gets or sets string ID of the bill.
    - `billStatus` 'Invalid' | 'Unpaid' | 'Paid' | 'Closed', required: Bill Status Type
    - `totalAmount` ServiceEfficiencyApiMoney, required: Temporary until https://roblox.atlassian.net/browse/ICSC-1360 is done. Will be replaced by google.type.Money
      - `currencyCode` string, nullable: The three-letter currency code defined in ISO 4217.
      - `units` integer: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
      - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `currentBalance` ServiceEfficiencyApiMoney, required: Temporary until https://roblox.atlassian.net/browse/ICSC-1360 is done. Will be replaced by google.type.Money
    - `currencyCode` string, nullable: The three-letter currency code defined in ISO 4217.
    - `units` integer: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `monthToDateBalance` ServiceEfficiencyApiMoney, required: Temporary until https://roblox.atlassian.net/browse/ICSC-1360 is done. Will be replaced by google.type.Money
    - `currencyCode` string, nullable: The three-letter currency code defined in ISO 4217.
    - `units` integer: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
  - `chargingThreshold` ServiceEfficiencyApiMoney, required: Temporary until https://roblox.atlassian.net/browse/ICSC-1360 is done. Will be replaced by google.type.Money
    - `currencyCode` string, nullable: The three-letter currency code defined in ISO 4217.
    - `units` integer: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
    - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-20** `365aada792ed`: 3 info
  - api tag `Accounts` added
  - api tag `Groups` added
  - api tag `Service Efficiency` added
- **2026-10-15** `e53153475cb2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/service-efficiency-api/v1/billing_activities/groups/:groupId/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)