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

# List PlanContents

> Retrieve a list of `PlanContent` objects.

You can use query parameters to filter, sort, and paginate the results.


You can set the `money_decimals` query parameter to specify the number of decimal places for money fields.

Examples:

- `?money_decimals=2` will return money values rounded to 2 decimal places.
- `?money_decimals=max` will return money values with the maximum precision.



## OpenAPI

````yaml /api-reference/services_documented/billing_reseller_api.yaml get /billing/org/v1/plans/contents
openapi: 3.1.0
info:
  title: Gcore OpenAPI – Billing Reseller API
  description: >-
    This OpenAPI is an aggregated OpenAPI specification that unifies all Gcore
    products into a single file. It covers Cloud, CDN, DNS, WAAP, DDoS
    Protection, Object Storage, Streaming, and FastEdge services.
  version: '2026-05-07T20:33:46.548242+00:00'
servers:
  - url: https://api.gcore.com
security:
  - APIKey: []
tags:
  - name: addendums
    description: Operations on client addendums
    x-displayName: addendums
  - name: calc_rules
    x-displayName: calc_rules
  - name: currencies
    x-displayName: currencies
  - name: erp-invoices
    x-displayName: erp-invoices
  - name: expenses
    description: Operations on expenses
    x-displayName: expenses
  - name: plans
    description: Operations on tariff plans and their contents
    x-displayName: plans
  - name: products
    x-displayName: products
  - name: reports
    description: >-
      Operations involving reports and the associated background tasks that
      handle their processing
    x-displayName: reports
  - name: trials
    x-displayName: trials
paths:
  /billing/org/v1/plans/contents:
    get:
      tags:
        - plans
      summary: List PlanContents
      description: >-
        Retrieve a list of `PlanContent` objects.


        You can use query parameters to filter, sort, and paginate the results.



        You can set the `money_decimals` query parameter to specify the number
        of decimal places for money fields.


        Examples:


        - `?money_decimals=2` will return money values rounded to 2 decimal
        places.

        - `?money_decimals=max` will return money values with the maximum
        precision.
      operationId: v1_plans_contents_list
      parameters:
        - in: query
          name: addendum_id
          schema:
            type: array
            items:
              type: integer
          description: Filter by Addendum ID. Can be multiple.
          explode: true
          style: form
        - in: query
          name: calc_rule_type
          schema:
            type: array
            items:
              type: string
              x-spec-enum-id: 46d5e926a44582db
              enum:
                - commit
                - commit_hourly
                - overcommit
                - staged
                - stepped
          description: |-
            Filter by calculation rule type. Can be multiple.

            - `commit` - commit
            - `overcommit` - overcommit
            - `stepped` - stepped
            - `staged` - staged
            - `commit_hourly` - `commit_hourly`
          explode: true
          style: form
        - in: query
          name: comment
          schema:
            type: string
        - in: query
          name: currency_char_code
          schema:
            type: array
            items:
              type: string
          description: |-
            Filter by currency char code (e.g. USD, EUR). Can be multiple.


            Returns currencies with the specified char code.


            **Examples:**

            - `&currency_char_code=USD`
            - `&currency_char_codeEUR&currency_char_codeUSD`



            **Available values:**

            - `EUR` - Euro
            - `USD` - US Dollar
          explode: true
          style: form
        - in: query
          name: currency_id
          schema:
            type: array
            items:
              type: integer
              nullable: true
          description: |-
            Filter by currency ID. Can be multiple.


            Returns currencies with the specified ID.


            **Examples:**

            - `&currency_id=1`
            - `&currency_id=1&currency_id=2`



            **Available values:**

            - `1` - US Dollar
            - `2` - Euro
          explode: true
          style: form
        - in: query
          name: default
          schema:
            type: boolean
        - in: query
          name: feature_id
          schema:
            type: array
            items:
              type: integer
          description: Filter by feature ID. Can be multiple.
          explode: true
          style: form
        - in: query
          name: feature_name
          schema:
            type: string
          description: Filter by feature name. Case insensitive. Supports partial matches.
        - in: query
          name: id
          schema:
            type: integer
        - name: limit
          required: false
          in: query
          description: Number of results to return per page. Maximum is `100`.
          schema:
            type: integer
        - in: query
          name: metric_ext_name
          schema:
            type: string
          description: Filter by metric code. Case insensitive. Supports partial matches.
        - in: query
          name: metric_id
          schema:
            type: array
            items:
              type: integer
              nullable: true
          description: Filter by metric ID. Can be multiple.
          explode: true
          style: form
        - name: offset
          required: false
          in: query
          description: The initial index from which to return the results.
          schema:
            type: integer
        - in: query
          name: ordering
          schema:
            type: array
            items:
              type: string
              enum:
                - '-calc_rule_type'
                - '-currency_id'
                - '-default'
                - '-feature_name'
                - '-id'
                - '-plan_id'
                - '-product_id'
                - '-product_name'
                - calc_rule_type
                - currency_id
                - default
                - feature_name
                - id
                - plan_id
                - product_id
                - product_name
          description: >-
            Ordering of the results.


            Default sort order is ascending. Put `-` before value for descending
            sort order: `-id`.


            For sorting by multiple parameters write them as comma separated
            string: `-client_id,id`.



            - `id` - Id

            - `-id` - Id (descending)

            - `currency_id` - Currency id

            - `-currency_id` - Currency id (descending)

            - `calc_rule_type` - Calc rule type

            - `-calc_rule_type` - Calc rule type (descending)

            - `feature_name` - Feature name

            - `-feature_name` - Feature name (descending)

            - `product_name` - Product name

            - `-product_name` - Product name (descending)

            - `product_id` - Product id

            - `-product_id` - Product id (descending)

            - `plan_id` - Plan id

            - `-plan_id` - Plan id (descending)

            - `default` - Default

            - `-default` - Default (descending)
          explode: false
          style: form
        - in: query
          name: plan_id
          schema:
            type: array
            items:
              type: integer
          description: Filter by plan ID. Can be multiple.
          explode: true
          style: form
        - in: query
          name: plan_name
          schema:
            type: string
          description: Filter by plan name. Case insensitive. Supports partial matches.
        - in: query
          name: product_category_id
          schema:
            type: array
            items:
              type: integer
          description: Filter by Product Category ID. Can be multiple.
          explode: true
          style: form
        - in: query
          name: product_category_name
          schema:
            type: string
          description: >-
            Filter by product category name. Case insensitive. Supports partial
            matches.
        - in: query
          name: product_id
          schema:
            type: array
            items:
              type: integer
          description: |-
            Filter by product ID. Can be multiple.

            Returns products with the specified ID.

            **Examples:**

            - `&product_id=1`
            - `&product_id=1&product_id=2`



            **Available values:**

            - `1` - CDN
            - `2` - Object Storage
            - `3` - Web Security
            - `4` - Streaming
            - `5` - Cloud
            - `6` - Colocation Services
            - `7` - WG Private Cloud
            - `8` - p2p
            - `9` - DDoS Protection
            - `10` - Managed DNS
            - `11` - Other Services
            - `12` - Premium Support
            - `13` - Connectivity
            - `14` - Hosting (G-Hosting)
            - `15` - Managed Services
            - `16` - Rent
            - `17` - Software development
            - `18` - VM Ware
            - `19` - LaaS
            - `20` - AWS Cloud
            - `21` - FastEdge
            - `22` - Technical Support
            - `23` - WAAP
            - `25` - Edge Proxy
            - `32` - AI Managed Dedicated Compute
            - `65` - Gclaw
          explode: true
          style: form
        - in: query
          name: product_internal_name
          schema:
            type: array
            items:
              type: string
          description: |-
            Filter by product internal name. Can be multiple.

            Returns products with the specified internal name.

            **Examples:**

            - `&product_internal_name=CDN`
            - `&product_internal_name=CDN&product_internal_name=DNS`



            **Available values:**

            - `AI_DEDCOMP` - AI Managed Dedicated Compute
            - `AWS_CLOUD` - AWS Cloud
            - `CDN` - CDN
            - `CLOUD` - Cloud
            - `CONNECT` - Colocation Services
            - `CONNECTIVITY` - Connectivity
            - `DDOS` - Web Security
            - `DNS` - Managed DNS
            - `FAST_EDGE` - FastEdge
            - `GCLAW` - Gclaw
            - `GHOST` - Hosting (G-Hosting)
            - `INFRASTRUCTURE_PROTECTION` - DDoS Protection
            - `LAAS` - LaaS
            - `MANAGED_SERVICES` - Managed Services
            - `OTHER_SERVICES` - Other Services
            - `P2P` - p2p
            - `PREMIUM_SUPPORT` - Premium Support
            - `RENT` - Rent
            - `SHIELD_PROXY` - Edge Proxy
            - `SOFTWARE_DEVELOPMENT` - Software development
            - `STORAGE` - Object Storage
            - `STREAMING` - Streaming
            - `TECHNICAL_SUPPORT` - Technical Support
            - `VMWARE` - VM Ware
            - `WAAP` - WAAP
            - `WG_PRIVATE_CLOUD` - WG Private Cloud
          explode: true
          style: form
        - in: query
          name: product_name
          schema:
            type: string
          description: Filter by product name. Case insensitive. Supports partial matches.
        - in: query
          name: region_id
          schema:
            type: array
            items:
              type: integer
          description: Filter by region ID. Can be multiple.
          explode: true
          style: form
        - in: query
          name: region_int_name
          schema:
            type: array
            items:
              type: string
          description: Filter by region internal name. Can be multiple.
          explode: true
          style: form
        - in: query
          name: region_name
          schema:
            type: string
          description: Filter by region name. Case insensitive. Supports partial matches.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PaginatedPlanContentForOrgSerializerV1List
          description: Request successful.
        '401':
          description: Authentication credentials were not provided or are invalid.
        '403':
          description: You do not have permission to perform this action.
components:
  schemas:
    PaginatedPlanContentForOrgSerializerV1List:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=400&limit=100
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?offset=200&limit=100
        results:
          type: array
          items:
            $ref: '#/components/schemas/PlanContentForOrgSerializerV1'
    PlanContentForOrgSerializerV1:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        plan_id:
          type: integer
          description: Tariff plan
          readOnly: true
        default:
          type: boolean
          readOnly: true
          description: >-
            Indicates whether the plan item is activated by default when the
            tariff is purchased.
        feature:
          allOf:
            - $ref: '#/components/schemas/FeatureCommonShort'
          readOnly: true
          description: Feature associated with the plan item.
        metric_ext_name:
          type: string
          readOnly: true
          description: Metric code of the feature associated with the expense.
        regions:
          type: array
          items:
            $ref: '#/components/schemas/StatisticRegionCommonShort'
          readOnly: true
        product_category:
          allOf:
            - $ref: '#/components/schemas/ProductCategoryCommonShort'
          readOnly: true
          description: Product category of the feature associated with the plan item.
        product:
          allOf:
            - $ref: '#/components/schemas/ProductCommonShort'
          readOnly: true
          description: Product associated with the plan.
        calc_rule_type:
          type: string
          readOnly: true
          description: Type of calculation rule for the plan item.
        unit:
          allOf:
            - $ref: '#/components/schemas/UnitCommon'
          readOnly: true
          description: >-
            Unit of measurement for the plan item. It is used for rounding and
            pricing calculations.
        unit_size:
          type: string
          format: decimal
          pattern: ^-?\d{0,24}(?:\.\d{0,8})?$
          readOnly: true
          description: Deprecated. Always returns 1.
        price:
          allOf:
            - $ref: '#/components/schemas/PriceCommonShort'
          readOnly: true
          description: >-
            Price associated with the plan item for the specified `unit` of
            measurement.
        default_value:
          type: string
          format: decimal
          pattern: ^-?\d{0,24}(?:\.\d{0,8})?$
          readOnly: true
          description: >-
            Default value for the plan item in the specified unit. This value is
            used when the plan item is activated by default.
        rounding_rule:
          allOf:
            - $ref: '#/components/schemas/RoundingRuleCommon'
          readOnly: true
          description: Rounding rule for the plan item.
        comment:
          type: string
          readOnly: true
          description: Comment for the plan item.
      required:
        - calc_rule_type
        - comment
        - default
        - default_value
        - feature
        - id
        - metric_ext_name
        - plan_id
        - price
        - product
        - product_category
        - regions
        - rounding_rule
        - unit
        - unit_size
    FeatureCommonShort:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          readOnly: true
        erp_sku_id:
          type: string
          readOnly: true
          nullable: true
      required:
        - erp_sku_id
        - id
        - name
    StatisticRegionCommonShort:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          readOnly: true
        external_name:
          type: string
          readOnly: true
      required:
        - external_name
        - id
        - name
    ProductCategoryCommonShort:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          maxLength: 255
      required:
        - id
        - name
    ProductCommonShort:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          readOnly: true
        internal_name:
          type: string
          maxLength: 25
      required:
        - id
        - internal_name
        - name
    UnitCommon:
      type: object
      properties:
        id:
          type: integer
          minimum: 1
          readOnly: true
          description: Unique internal identifier of the unit.
        name:
          type: string
          readOnly: true
          description: Name of the unit.
        internal_name:
          type: string
          readOnly: true
          description: Internal name of the unit.
      required:
        - id
        - internal_name
        - name
    PriceCommonShort:
      type: object
      description: >-
        Read-only serializer for price data in common API responses.


        This serializer reads from `price_json` instead of the legacy Price
        model

        while maintaining the same API response structure.
      properties:
        currency:
          allOf:
            - $ref: '#/components/schemas/CurrencyCommonShort'
          readOnly: true
          description: Currency of the price, used for monetary calculations.
        money_value:
          description: The monetary value of the price in the specified currency.
          type: string
          format: decimal
          pattern: ^\d{1,3}\.\d{12}$
          readOnly: true
        price_stages:
          type: array
          items:
            $ref: '#/components/schemas/PriceStageCommon'
          readOnly: true
          description: Stages of the price, if applicable.
      required:
        - currency
        - money_value
        - price_stages
    RoundingRuleCommon:
      type: object
      properties:
        unit:
          allOf:
            - $ref: '#/components/schemas/UnitCommon'
          readOnly: true
          description: Unit of measurement for the rounding rule.
        value:
          type: string
          format: decimal
          pattern: ^-?\d{0,24}(?:\.\d{0,8})?$
          description: Value for the rounding rule in the specified `unit`.
        round_operation:
          enum:
            - ceil
            - floor
          type: string
          description: |-
            - `ceil` - ceil
            - `floor` - floor
          x-spec-enum-id: df25e82b156366e8
      required:
        - unit
        - value
    CurrencyCommonShort:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        char_code:
          type: string
          description: Currency iso4217 char code
          pattern: ^[A-Z]{3}$
          maxLength: 3
        symbol:
          type: string
          nullable: true
          description: Currency symbol, for example '$'
          maxLength: 10
      required:
        - char_code
        - id
    PriceStageCommon:
      type: object
      description: Read-only serializer for price stage data in common API responses.
      properties:
        money_value:
          description: The monetary value of the price stage in the specified currency.
          type: string
          format: decimal
          pattern: ^\d{1,3}\.\d{12}$
          readOnly: true
        threshold:
          type: string
          format: decimal
          pattern: ^-?\d{0,24}(?:\.\d{0,12})?$
          readOnly: true
          description: Threshold for the price in the specified `unit`.
      required:
        - money_value
        - threshold
  securitySchemes:
    APIKey:
      description: >-
        API key for authentication. Make sure to include the word `apikey`,
        followed by a single space and then your token.

        Example: `apikey 1234$abcdef`
      type: apiKey
      in: header
      name: Authorization

````