Skip to main content
Costory ingests raw billing exports from each cloud provider and normalizes them into a consistent set of cos_* columns. This lets you query, filter, and group costs across providers using a single schema — no need to learn each provider’s billing format. Columns are organized into the following categories:
CategoryDescription
InvoiceFields sourced directly from the provider billing export (accounts, charges, services, regions, resources, Kubernetes labels)
CostoryFields enriched by Costory (standardized region names, compute metadata, pricing model, marketplace flag)
DatasourcesThe Costory datasource that produced the row

​
Datasource & Provider Identification

​
Invoice Issuer

The legal entity issuing the invoice, it also helps identifying marketplace purchases.
Sourced from line_item_legal_entity.

​
Account & Billing

​
Billing Account Id

The top-level billing or payer account.
bill_payer_account_id

​
Sub Account ID / Project ID

The sub-account, project, or subscription under which the cost is incurred.
line_item_usage_account_name

​
Charge Classification

​
Charge Category

Classifies the type of charge. Normalized to one of: Usage, Purchase, Tax, Adjustment.
Mapped from line_item_line_item_type: - Usage, SavingsPlanCoveredUsage, SavingsPlanNegation, DiscountedUsage, BundledDiscount, Discount, PrivateRateDiscount, EdpDiscount → Usage - Fee, SavingsPlanUpfrontFee, RIFee, SavingsPlanRecurringFee → Purchase - Credit, Refund → Adjustment - Tax → Tax

​
Charge Description

A human-readable description of the charge line item.
line_item_line_item_description

​
Charge Frequency

How often the charge recurs. Normalized to: One-Time, Recurring, Usage-Based.
Based on bill_bill_type: - Refund or Purchase → One-Time - Anniversary → Recurring

​
Service & SKU

​
Category

A high-level cost category such as Compute, Storage, or Networking. Mapped from a defined list of services.

​
Service Name

The name of the cloud service.
line_item_product_code for first-party services. For marketplace, extracted from product.key_value (product_name).

​
SKU ID

The SKU identifier.
product_sku for first-party services; marketplace product name otherwise.

​
SKU Description

A human-readable SKU description.
CONCAT(product_operation, "_", product_product_family) for first-party services; marketplace product name otherwise.

​
Location & Infrastructure

​
Availability Zone

The availability zone of the resource.
line_item_availability_zone

​
Region ID

The raw, provider-specific region identifier.
product.key_value["region"] or product_region_code

​
Region

The standardized, human-readable region name. Costory maps each provider’s raw region identifier to a common name via an internal region mapper.
StandardRegionName joined on product_region_code.

​
Resource

​
Resource Id

The unique identifier of the resource.
line_item_resource_id

​
Resource Name

A human-readable name for the resource.
line_item_resource_id (same as Resource Id).

​
Commitment Discounts

​
Commitment Discount Category

The type of commitment discount. Usage indicates a resource-based commitment (Reserved Instances, resource-based CUDs). Spend indicates a dollar-based commitment (Savings Plans, dollar-based CUDs).
  • Savings Plan ARN present → Spend - Reservation ARN present → Usage

​
Commitment Discount Id

The identifier of the commitment discount (ARN, CUD name, or benefit ID).
savings_plan_savings_plan_a_r_n or reservation_reservation_a_r_n

​
Compute Enrichment

These fields are enriched by Costory to provide deeper visibility into compute spend.

​
Machine Type

The instance or machine type (e.g., m5.xlarge, n2-standard-4).
Extracted from line_item_usage_type after the : separator.

​
Machine Family

The machine family (e.g., m5, n2, Dv3).
First part of the machine type (split on .).

​
Pricing Model (Spot / On Demand)

How the resource is priced. Normalized to: On Demand, Spot, Reservation, Savings Plan.
  • DiscountedUsage → Reservation - SavingsPlanCoveredUsage → Savings Plan - Usage type contains SpotUsage → Spot - Usage → On Demand

​
Marketplace Purchase

Whether the charge is a marketplace purchase. This field is not populated directly by billing converters — it is derived downstream by Costory.

​
Line Item Usage Type

The raw usage type from the provider. Not populated as a cos_* column in converters — available via provider-specific labels (e.g., aws_line_item_usage_type for AWS).
line_item_usage_type

​
Kubernetes

These fields provide Kubernetes-level cost attribution. For GCP, most are populated natively from GKE billing labels. For AWS and Azure, they are typically enriched downstream via Costory’s K8s integration.

​
K8s Cluster Name

The name of the kubernetes cluster.
NULL (populated downstream via K8s enrichment).

​
K8s Namespace

The kubernetes namespace for that cost.
NULL

​
K8s Namespace Reallocated

Namespace reallocated: is a view over namespace with the waste cost reallocated to each namespace depending on their usage: this is only available on AWS EKS.

​
K8s Workload Name

The name of the workload, it’s the name of pod it can contain ids.
NULL

​
K8s Workload Type

The Kubernetes workload type (Deployment, StatefulSet, DaemonSet, etc.).
NULL

​
K8s Node Pool Name

The name of the node pool (node group in AWS).
Resource tag matching nodegroup_name.
Last modified on February 13, 2026