---
title: "Datacenter bandwidth periods"
method: GET
path: "/v4/account/{subAccountId}/datacenter_shared/periods"
tags: ["Datacenter"]
---

# Datacenter bandwidth periods

`GET /v4/account/{subAccountId}/datacenter_shared/periods`

Get the current billing period and upcoming prepaid periods for a datacenter subaccount. Returns `periods_supported: false` if the subaccount does not use bandwidth-based billing. Permission: `datacenter_shared:read` or `datacenter_dedicated:read`.

## Path parameters

- `subAccountId` string, uuid, required

## Response `200`

Billing periods for the datacenter subaccount

- union
  - object — Returned when the subaccount does not support bandwidth-based billing periods.
    - `periods_supported` false, required
  - object — Returned when the subaccount supports bandwidth-based billing periods.
    - `current_period` object, nullable, required — The active billing period. `null` if no period has started yet.
      - `start` integer — Unix timestamp when the current period started.
      - `end` integer — Unix timestamp when the current period ends.
      - `bandwidth_bytes` integer — Total bandwidth allocation for this period in bytes.
      - `bandwidth_used_bytes` integer, nullable — Bytes consumed so far this period. `null` if usage data could not be retrieved.
      - `bandwidth_remaining_bytes` integer, nullable — Bytes remaining this period. `null` if usage data could not be retrieved.
    - `remaining_periods` object[], required — Prepaid periods queued after the current period, with estimated start and end timestamps.
      - `days` integer — Duration of this queued period in days.
      - `estimated_start` integer — Estimated Unix timestamp when this period will begin.
      - `estimated_end` integer — Estimated Unix timestamp when this period will end.
    - `total_periods_remaining` integer, required — Total number of prepaid periods queued after the current period.

## Other responses

- `403` — Access denied — invalid subaccount or insufficient permissions.
- `404` — Subaccount not found.

---

[API](https://skmtc.net/proxyscrape/apis/proxyscrape-account-api.md) · [All operations](https://skmtc.net/proxyscrape/apis/proxyscrape-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/proxyscrape/proxyscrape-account-api/versions/4e10267785e1/schema)