Generate FOCUS-compliant cost report

Shows how to generate and download a cost report in FOCUS format using the Redis Cloud REST API.

You can use the Redis Cloud REST API to generate and download a cost report in a FinOps Open Cost and Usage Specification (FOCUS) compatible format. The report includes detailed information about your Redis Cloud subscription usage and associated charges.

To get the cost report using the REST API:

1. Use POST /cost-report 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.

   The response includes a taskId that you can use to track the status of the report generation.

2. Use GET /tasks/{taskId} to check report generation status. The report is ready when the status is processing-completed and the response field contains a costReportId.

3. Use GET /cost-report/{costReportId} to download the generated cost report.

The following sections provide examples for each step.

Generate a cost report

To generate a cost report, use POST /cost-report. Your account must have the Owner or Viewer role to generate a cost report through this endpoint.

Include startDate and endDate in your request body using YYYY-MM-DD format. You can specify a date range up to 40 days.

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-31"
}

More options and filters can be added to the request body to filter the report data.

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:

{
  "startDate": "2025-01-01",
  "endDate": "2025-01-31",
  "format": "csv",
  "regions": ["us-east-1"],
  "tags": [
    {
      "key": "team",
      "value": "marketing"
    }
  ]
}

The response body is a task object that contains the taskId for the task that generates the cost report:

{
  "taskId": "7ba51acc-cd1d-44c7-8453-281730d214ce",
  "commandType": "costReportCreateRequest",
  "status": "received",
  "description": "Task request received and is being queued for processing.",
  "timestamp": "2025-11-07T15:44:29.811142433Z",
  "links": [
    {
      "href": "https://api.redislabs.com/v1/tasks/7ba51acc-cd1d-44c7-8453-281730d214ce",
      "type": "GET",
      "rel": "task"
    }
  ]
}

Get cost report status

To get the status of the cost report generation, use GET /tasks/{taskId} with the taskId from the previous step.

When the report is ready, the status is processing-completed and the response field contains a costReportId:

{
  "taskId": "7ba51acc-cd1d-44c7-8453-281730d214ce",
  "commandType": "costReportCreateRequest",
  "status": "processing-completed",
  "description": "Request processing completed successfully and its resources are now being provisioned / de-provisioned.",
  "timestamp": "2025-11-07T15:44:31.168900133Z",
  "response": {
    "resource": {
      "costReportId": "a07524cf-6d4d-47ec-a1b7-810d1cbafcf7.json"
    }
  },
  "links": [
    {
      "href": "https://api.redislabs.com/v1/tasks/7ba51acc-cd1d-44c7-8453-281730d214ce",
      "type": "GET",
      "rel": "self"
    }
  ]
}

Download cost report

To get the cost report, use GET /cost-report/{costReportId} 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. The Redis Cloud-specific implementation is described in the following sections.

Billing account and publisher fields

Pricing fields

Period fields

Cost fields

Location, Resource, and SKU fields

Charge fields

Service fields