You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
1. Use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}) to generate a cost report, with the request body containing the `startDate` and `endDate` for the report as well as any optional filters. The response includes a `taskId` that you can use to track the status of the report generation.
4
-
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 will contain a `costReportId`.
3
+
1. Use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}) to generate a cost report, with the request body containing the `startDate` and `endDate` for the report as well as any optional filters. Your account must have the **Owner** or **Viewer** role to generate a cost report through this endpoint.
4
+
5
+
The response includes a `taskId` that you can use to track the status of the report generation.
6
+
7
+
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`.
5
8
1. Use [`GET /cost-report/{costReportId}`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/getCostReport" >}}) to download the generated cost report.
6
9
7
10
The cost report returned from the Redis Cloud REST API contains all columns from the [FOCUS column library](https://focus.finops.org/focus-columns/).
Copy file name to clipboardExpand all lines: content/operate/rc/api/examples/generate-cost-report.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,6 +7,7 @@ categories:
7
7
- operate
8
8
- rc
9
9
description: Shows how to generate and download a cost report in FOCUS format using the Redis Cloud REST API.
10
+
bannerText: The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint.
10
11
weight: 60
11
12
---
12
13
@@ -18,27 +19,27 @@ The following sections provide examples for each step.
18
19
19
20
## Generate a cost report
20
21
21
-
To generate a cost report, use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}).
22
+
To generate a cost report, use [`POST /cost-report`]({{< relref "/operate/rc/api/api-reference#tag/Account/operation/createCostReport" >}}). Your account must have the **Owner** or **Viewer** role to generate a cost report through this endpoint.
22
23
23
-
The request body must contain the `startDate` and `endDate`for the report in `YYYY-MM-DD` format.
24
+
Include `startDate` and `endDate`in your request body using `YYYY-MM-DD` format. You can specify a date range up to 40 days.
24
25
25
26
```json
26
27
{
27
28
"startDate": "2025-01-01",
28
-
"endDate": "2025-12-31"
29
+
"endDate": "2025-01-31"
29
30
}
30
31
```
31
32
32
33
More options and filters can be added to the request body to filter the report data.
33
34
34
35
| Option name | Type | Description |
35
36
|-------------|--------|-------------|
36
-
|`format`| Enum: `csv`, `json`| The format for the report file. Default is `json`. |
37
+
|`format`| Enum: `csv`, `json`| The format for the report file. Default is `csv`. |
37
38
|`subscriptionIds`| Array of integers | Filters the report to only include the specified subscriptions. |
38
39
|`databaseIds`| Array of integers | Filters the report to only include the specified databases. |
39
40
|`subscriptionType`| Enum: `essentials`, `pro`| Filters the report to only include subscriptions of the specified type. |
40
41
|`regions`| Array of strings | Filters the report to only include subscriptions in the specified regions. |
41
-
|`tags`| Array of key-value pairs | Filters the report to only include databases with the specified [tags]({{< relref "/operate/rc/databases/tag-database" >}}). |
42
+
|`tags`| Array of key-value pairs | Filters the report to only include databases with the specified [tags]({{< relref "/operate/rc/databases/tag-database" >}}). Both `key` and `value` are required for each tag. |
42
43
43
44
For example, the following request body generates a CSV report for all databases in the `us-east-1` region that have the `team:marketing` tag in January 2025:
Copy file name to clipboardExpand all lines: content/operate/rc/billing-and-payments/cost-report.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -93,6 +93,10 @@ All columns after the **Total cost** column show the key values for any [tags]({
93
93
94
94
## Get FOCUS format using REST API
95
95
96
+
{{< note >}}
97
+
The cost report API endpoint is currently in preview. [Contact support](https://redis.io/support/) to request access to this endpoint.
98
+
{{< /note >}}
99
+
96
100
You can use the [Redis Cloud REST API]({{< relref "/operate/rc/api" >}}) to get a cost report in [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compatible format.
description: New features, enhancements, and other changes added to Redis Cloud during
9
+
December 2025.
10
+
highlights: FOCUS-compliant cost reports with REST API
11
+
linktitle: December 2025
12
+
weight: 55
13
+
tags:
14
+
- changelog
15
+
---
16
+
17
+
## New features
18
+
19
+
### FOCUS-compliant cost reports with REST API
20
+
21
+
Select users can now generate and download [cost reports]({{< relref "/operate/rc/billing-and-payments/cost-report" >}}) in a [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compliant format using the Redis Cloud REST API. You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs.
22
+
23
+
[Contact support](https://redis.io/support/) to request access to the cost report endpoint.
24
+
25
+
See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples.
Copy file name to clipboardExpand all lines: content/operate/rc/changelog/november-2025.md
+1-7Lines changed: 1 addition & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ categories:
7
7
- rc
8
8
description: New features, enhancements, and other changes added to Redis Cloud during
9
9
November 2025.
10
-
highlights: Redis 8.2 on Redis Cloud Pro, FOCUS-compliant cost reports
10
+
highlights: Redis 8.2 on Redis Cloud Pro
11
11
linktitle: November 2025
12
12
weight: 60
13
13
tags:
@@ -16,12 +16,6 @@ tags:
16
16
17
17
## New features
18
18
19
-
### FOCUS-compliant cost reports
20
-
21
-
You can now generate and download [cost reports]({{< relref "/operate/rc/billing-and-payments/cost-report" >}}) in a [FinOps Open Cost and Usage Specification (FOCUS)](https://focus.finops.org/) compliant format using the Redis Cloud REST API. You can use this cost report with any FOCUS-compatible cost reporting tool to analyze and visualize your costs.
22
-
23
-
See [Generate FOCUS-compliant cost report with REST API]({{< relref "/operate/rc/api/examples/generate-cost-report" >}}) for examples.
24
-
25
19
### Redis 8.2 on Redis Cloud Pro
26
20
27
21
Redis 8.2 is now available on Redis Cloud Pro. You can now upgrade your existing Pro database to Redis 8.2.
0 commit comments