Get itemized costs for the organization.

GET /api/v2/billing/organizations/{organization_id}/costs/items

Retrieves costs associated with all items for the organization. Admin callers receive all items; non-admin user callers are filtered to items billed against instances they have access to.

Headers

  • Accept string

    Determines the response body format. Can be either application/json or text/csv.

Path parameters

  • organization_id string Required

    Identifier for the organization

Query parameters

  • from string Required

    A datetime for the beginning of the desired range.

  • to string Required

    A datetime for the end of the desired range.

  • serverless_group_by string

    How to group the serverless items.

    Values are product or product_family.

Responses

  • 200 application/json

    Success. The costs associated to a set of items.

    Hide response attributes Show response attributes object
    • products array[object] Required

      Product(total_ecu: 'int', type: 'str', product_line_items: 'list[ProductLineItem]')

      Hide products attributes Show products attributes object

      Product(total_ecu: 'int', type: 'str', product_line_items: 'list[ProductLineItem]')

      • product_line_items array[object] Required

        ProductLineItem(name: 'str', total_ecu: 'int', type: 'str', sku: 'str', unit: 'str', quantity: 'Quantity', display_quantity: 'DisplayQuantity', rate: 'Rate', kind: 'str | None', quantities: 'list[ProductLineItemQuantity]')

        Hide product_line_items attributes Show product_line_items attributes object

        ProductLineItem(name: 'str', total_ecu: 'int', type: 'str', sku: 'str', unit: 'str', quantity: 'Quantity', display_quantity: 'DisplayQuantity', rate: 'Rate', kind: 'str | None', quantities: 'list[ProductLineItemQuantity]')

        • display_quantity object Required

          Display quantity

          Hide display_quantity attributes Show display_quantity attributes object
        • kind string
        • name string Required
        • quantities array[object] Required

          Represents the cost structure, segmenting the quantities by price range and allocating the usage to tiers if price is tiered. If price is not tiered and if the pricing didn't change during the entire usage range, quantities will be empty (otherwise it would be redundant data).

          Hide quantities attributes Show quantities attributes object

          Represents the cost structure, segmenting the quantities by price range and allocating the usage to tiers if price is tiered. If price is not tiered and if the pricing didn't change during the entire usage range, quantities will be empty (otherwise it would be redundant data).

          • from string(date-time) Required
          • quantity object

            Quantity

            Hide quantity attributes Show quantity attributes object
          • rate object Required

            Rate(value: 'int', formatted_value: 'str')

            Hide rate attributes Show rate attributes object
            • formatted_value string Required
            • value integer Required
          • tiers array[object] Required

            ProductLineItemTier(min: 'int', max: 'int | None', total_ecu: 'int', quantity: 'Quantity', rate: 'Rate')

            Hide tiers attributes Show tiers attributes object

            ProductLineItemTier(min: 'int', max: 'int | None', total_ecu: 'int', quantity: 'Quantity', rate: 'Rate')

            • max integer
            • min integer Required
            • quantity object Required

              Quantity

              Hide quantity attributes Show quantity attributes object
            • rate object Required

              Rate(value: 'int', formatted_value: 'str')

              Hide rate attributes Show rate attributes object
              • formatted_value string Required
              • value integer Required
            • total_ecu integer Required
          • to string(date-time) Required
          • total_ecu integer Required
        • quantity object Required

          Quantity

          Hide quantity attributes Show quantity attributes object
        • rate object Required

          Rate(value: 'int', formatted_value: 'str')

          Hide rate attributes Show rate attributes object
          • formatted_value string Required
          • value integer Required
        • sku string Required
        • total_ecu integer Required
        • type string Required
        • unit string Required
      • total_ecu integer Required
      • type string Required
    • total_ecu integer Required
  • 400

    The specified data range is invalid.

  • 403

    Current user does not have access to the requested organization.

  • 404

    Organization not found.

  • 500

    Internal server error.

GET /api/v2/billing/organizations/{organization_id}/costs/items 
curl \
 --request GET 'https://cloud.elastic.co/api/v2/billing/organizations/{organization_id}/costs/items?from=2021-04-21T00%3A00%3A00%2B00%3A00&to=2021-04-21T00%3A00%3A00%2B00%3A00' \
 --header "Accept: string"