> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proxyscrape.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datacenter bandwidth 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`.



## OpenAPI

````yaml /openapi-account.json get /v4/account/{subAccountId}/datacenter_shared/periods
openapi: 3.0.3
info:
  title: ProxyScrape Account API
  description: Account API — authenticate with the api-token header.
  version: 1.0.0
servers:
  - url: https://api.proxyscrape.com
    description: ProxyScrape API
security:
  - apiToken: []
tags:
  - name: API key management
    description: Create, list, update, regenerate, and revoke API keys
  - name: Subaccounts
    description: List subaccounts and manage preferences
  - name: Datacenter
    description: 'Datacenter shared and dedicated: overview, proxy list, usage, whitelist'
  - name: Residential
    description: 'Residential (bandwidth): overview, subusers, usage'
  - name: Residential unlimited
    description: 'Residential unlimited: overview, statistics, password'
  - name: SERP API
    description: 'SERP API: overview, subusers, search'
  - name: API ordering
    description: >-
      Place wallet-paid orders and read the wallet balance via the headless API
      ordering surface.
paths:
  /v4/account/{subAccountId}/datacenter_shared/periods:
    get:
      tags:
        - Datacenter
      summary: Datacenter bandwidth periods
      description: >-
        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`.
      operationId: getDatacenterPeriods
      parameters:
        - name: subAccountId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Billing periods for the datacenter subaccount
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    description: >-
                      Returned when the subaccount does not support
                      bandwidth-based billing periods.
                    properties:
                      periods_supported:
                        type: boolean
                        enum:
                          - false
                    required:
                      - periods_supported
                  - type: object
                    description: >-
                      Returned when the subaccount supports bandwidth-based
                      billing periods.
                    properties:
                      current_period:
                        type: object
                        nullable: true
                        description: >-
                          The active billing period. `null` if no period has
                          started yet.
                        properties:
                          start:
                            type: integer
                            description: Unix timestamp when the current period started.
                          end:
                            type: integer
                            description: Unix timestamp when the current period ends.
                          bandwidth_bytes:
                            type: integer
                            description: >-
                              Total bandwidth allocation for this period in
                              bytes.
                          bandwidth_used_bytes:
                            type: integer
                            nullable: true
                            description: >-
                              Bytes consumed so far this period. `null` if usage
                              data could not be retrieved.
                          bandwidth_remaining_bytes:
                            type: integer
                            nullable: true
                            description: >-
                              Bytes remaining this period. `null` if usage data
                              could not be retrieved.
                      remaining_periods:
                        type: array
                        description: >-
                          Prepaid periods queued after the current period, with
                          estimated start and end timestamps.
                        items:
                          type: object
                          properties:
                            days:
                              type: integer
                              description: Duration of this queued period in days.
                            estimated_start:
                              type: integer
                              description: >-
                                Estimated Unix timestamp when this period will
                                begin.
                            estimated_end:
                              type: integer
                              description: >-
                                Estimated Unix timestamp when this period will
                                end.
                      total_periods_remaining:
                        type: integer
                        description: >-
                          Total number of prepaid periods queued after the
                          current period.
                    required:
                      - current_period
                      - remaining_periods
                      - total_periods_remaining
        '403':
          description: Access denied — invalid subaccount or insufficient permissions.
        '404':
          description: Subaccount not found.
      security:
        - apiToken: []
components:
  securitySchemes:
    apiToken:
      type: apiKey
      in: header
      name: api-token
      description: >-
        API key. Create and manage keys at /v4/account/api-keys or in the
        dashboard.

````