v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB

Cloud Cost Management

List Custom Costs files

List the Custom Costs files.

get/api/v2/cost/custom_costs

Query parameters

page[number]integer

Page number for pagination

page[size]integer

Page size for pagination

filter[status]string

Filter by file status

filter[name]string

Filter files by name with case-insensitive substring matching.

filter[provider]string[]

Filter by provider.

sortstring

Sort key with optional descending prefix

Response

Example response

{
  "data": [
    {
      "attributes": {
        "billed_cost": 100.5,
        "billing_currency": "USD",
        "charge_period": {
          "end": 1706745600000,
          "start": 1704067200000
        },
        "name": "my_file.json",
        "provider_names": [
          "my_provider"
        ],
        "status": "active",
        "uploaded_at": 1704067200000,
        "uploaded_by": {
          "email": "email.test@datadohq.com",
          "icon": "icon.png",
          "name": "Test User"
        }
      }
    }
  ]
}