Sign in

v51

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-01169142751.2 KB
Account

Generate cost report

Generates a cost report in FOCUS format for the specified time period (max 40 days range) and filters. Read more about focus here.

post/v1/cost-report

Request body

startDatestring YYYY-MM-DD required

Filter for usage starting on or after this date. Must be in format YYYY-MM-DD

endDatestring YYYY-MM-DD required

Filter for usage ending on or before this date. Must be in format YYYY-MM-DD and must be after start date

format'json' | 'csv'

Output format for the cost report

subscriptionIdsinteger[]

Array of subscriptionIDs to filter by

databaseIdsinteger[]

Array of database IDs to filter by

subscriptionType'pro' | 'essentials'

Filter by plan type

regionsstring[]

Array of regions to filter by

commandTypestring

Example request

{
  "startDate": "2025-10-01",
  "endDate": "2025-11-06",
  "format": "csv",
  "subscriptionIds": [
    123,
    456
  ],
  "databaseIds": [
    789,
    101112
  ],
  "subscriptionType": "pro",
  "regions": [
    "us-east-1",
    "eu-west-1"
  ],
  "tags": [
    {
      "key": "environment",
      "value": "production"
    }
  ]
}

Response

Accepted

taskIdstring uuid
commandTypestring
status'initialized' | 'received' | 'processing-in-progress' | 'processing-completed' | 'processing-error'
descriptionstring
timestampstring date-time
linksobject[]