Add field reference

Author: cmilesb

content/embeds/rc-cost-report-api.md

@@ -5,6 +5,4 @@ To get the cost report using the REST API:
     The response includes a `taskId` that you can use to track the status of the report generation.
 
 1. Use [`GET /tasks/{taskId}`]({{< relref "/operate/rc/api/api-reference#tag/Tasks/operation/getTaskById" >}}) to check report generation status. The report is ready when the `status` is `processing-completed` and the `response` field contains a `costReportId`.
-1. Use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) to download the generated cost report.
-
-The cost report returned from the Redis Cloud REST API contains all columns from the [FOCUS column library](https://focus.finops.org/focus-columns/).
+1. Use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) to download the generated cost report.

content/operate/rc/api/examples/generate-cost-report.md

@@ -110,3 +110,77 @@ When the report is ready, the `status` is `processing-completed` and the `respon
 To get the cost report, use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) with the `costReportId` from the previous step.
 
 You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs.
+
+### Cost report fields
+
+The cost report returned from the Redis Cloud REST API contains fields from the [FOCUS column library](https://focus.finops.org/focus-columns/). The Redis Cloud-specific implementation is described in the following sections.
+
+#### Billing account and publisher fields
+
+| Field | Type | Description |
+|---|---|---|
+| `BillingAccountId` | String | Redis Cloud account ID. |
+| `BillingAccountName` | String | Display name of the Redis Cloud account. |
+| `BillingAccountType` | String | Type of billing account structure. Always set to `Redis Cloud`. |
+| `PublisherName` | String | Publisher/vendor of the service, which is Redis. Always `redis.io`. |
+
+#### Pricing fields
+
+| Field | Type | Description |
+|---|---|---|
+| `PricingCategory` | String | Pricing model category. Always `Standard`. |
+| `PricingCurrency` | String | The currency used for pricing. Always `USD`. |
+| `PricingQuantity` | BigDecimal | Quantity of units being priced. For hourly services like Redis Cloud Pro, this is the number of hours. For monthly services like Redis Cloud Essentials and network costs, this is typically one month. |
+| `PricingUnit` | String | The unit of measure for pricing. Can be `Hours` (Pro), `Months` (Essentials), or `Network`. |
+
+#### Period fields
+
+| Field | Type | Description |
+|---|---|---|
+| `BillingPeriodStart` | Instant (ISO 8601 DateTime) | Start of the billing period (inclusive). |
+| `BillingPeriodEnd` | Instant (ISO 8601 DateTime) | End of the billing period (exclusive). |
+| `ChargePeriodStart` | Instant (ISO 8601 DateTime) | Start of the specific charge period (inclusive). May differ from billing period if the resource was created mid-period. |
+| `ChargePeriodEnd` | Instant (ISO 8601 DateTime) | End of the specific charge period (exclusive). May differ from billing period if the resource was deleted mid-period. |
+
+#### Cost fields
+
+| Field | Type | Description |
+|---|---|---|
+| `BilledCost` | BigDecimal | Cost that Redis will invoice you for. |
+| `BillingCurrency` | String (ISO 4217) | Currency code for all billing amounts. Always `USD`. |
+| `ConsumedQuantity` | BigDecimal | Actual amount of resources used. May be null for fixed-price plans. |
+| `ConsumedUnit` | String | Unit for `ConsumedQuantity`. Can be `Hours` or `Network`. |
+| `ContractedCost` | BigDecimal | Cost after applying contractual discounts but before credits. |
+| `ContractedUnitPrice` | BigDecimal | Per-unit price after applying your negotiated discounts. |
+| `EffectiveCost` | BigDecimal | True cost after all discounts, credits, and adjustments. |
+| `ListCost` | BigDecimal | Cost at Redis's published list prices before any discounts. |
+| `ListUnitPrice` | BigDecimal | Redis's published price per unit at list rates. |
+
+#### Location, Resource, and SKU fields
+
+| Field | Type | Description |
+|---|---|---|
+| `RegionId` | String | Cloud vendor region identifier. |
+| `RegionName` | String | Display name of the region. |
+| `ResourceId` | String | Identifier of the resource being charged. |
+| `ResourceName` | String | Display name you gave to the resource in the Redis Cloud console. |
+| `ResourceType` | String | Whether the charge is for a specific database or a subscription-level service. |
+| `Tags` | JSON Map<String, String> | User-defined tags on resources. |
+| `SkuPriceDetails` | JSON Map<String, Object> | Redis-specific technical details about the database configuration, such as RBUs, memory limit, and throughput. |
+
+#### Charge fields
+
+| Field | Type | Description |
+|---|---|---|
+| `ChargeCategory` | String | Category of the charge: `Usage`, `Purchase`, `Tax`, or `Adjustment`. |
+| `ChargeDescription` | String | A clear description of what you're being charged for, combining service type and resource details. |
+| `ChargeFrequency` | String | How often the charge occurs - always `Recurring`. |
+
+#### Service fields
+
+| Field | Type | Description |
+|---|---|---|
+| `ServiceCategory` | String | The high-level category of service - always `Databases`. |
+| `ServiceName` | String | The Redis Cloud service tier - `Redis Cloud Pro` or `Redis Cloud Essentials`. |
+| `ServiceSubcategory` | String | The specific type of database service - always `Caching`. |
+

content/operate/rc/billing-and-payments/cost-report.md

@@ -101,4 +101,4 @@ You can use the [Redis Cloud REST API]({{< relref "/operate/rc/api" >}}) to get
 
 {{< embed-md "rc-cost-report-api.md" >}}
 
-See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples.
+The cost report returned from the Redis Cloud REST API contains fields from the [FOCUS column library](https://focus.finops.org/focus-columns/). See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for more details.