Skip to main content
GET
/
cost-insights
/
shared-filters
/
{filterId}
Get shared filter
curl --request GET \
  --url https://api.cloudcapital.co/v1/cost-insights/shared-filters/{filterId} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "filterConfiguration": {
      "filters": {
        "inclusions": {
          "costLayers": [
            "<string>"
          ],
          "clouds": [
            "<string>"
          ],
          "services": [
            "<string>"
          ],
          "resourceFamilies": [
            "<string>"
          ],
          "regions": [
            "<string>"
          ],
          "instanceTypes": [
            "<string>"
          ],
          "usageTypes": [
            "<string>"
          ],
          "billingPeriods": [
            "<string>"
          ],
          "dateRange": {
            "start": "2026-01-01",
            "end": "2026-03-31"
          },
          "costTypes": [
            "<string>"
          ],
          "accountIds": [
            "<string>"
          ],
          "integrationIds": [
            "<string>"
          ],
          "resourceTag": "<string>",
          "resourceTagValues": [
            "<string>"
          ],
          "costCategory": "<string>",
          "costCategoryValues": [
            "<string>"
          ]
        },
        "exclusions": {
          "costLayers": [
            "<string>"
          ],
          "clouds": [
            "<string>"
          ],
          "services": [
            "<string>"
          ],
          "resourceFamilies": [
            "<string>"
          ],
          "regions": [
            "<string>"
          ],
          "instanceTypes": [
            "<string>"
          ],
          "usageTypes": [
            "<string>"
          ],
          "billingPeriods": [
            "<string>"
          ],
          "dateRange": {
            "start": "2026-01-01",
            "end": "2026-03-31"
          },
          "costTypes": [
            "<string>"
          ],
          "accountIds": [
            "<string>"
          ],
          "integrationIds": [
            "<string>"
          ],
          "resourceTag": "<string>",
          "resourceTagValues": [
            "<string>"
          ],
          "costCategory": "<string>",
          "costCategoryValues": [
            "<string>"
          ]
        }
      },
      "groupBy": {
        "dimension": "<string>"
      },
      "metric": "<string>",
      "comparisonEnabled": true,
      "metadata": {
        "name": "<string>",
        "description": "<string>"
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.cloudcapital.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication. Generate an API key from your Cloud Capital dashboard under Settings > API keys. Include it in the Authorization header as a Bearer token.

Path Parameters

​
filterId
string
required

The unique identifier of the shared filter

Response

Shared filter retrieved successfully

Successful HTTP responses wrap the endpoint-specific body in data. Each operation's 200 response schema is this object merged (allOf) with a data property referencing the payload schema for that endpoint.

​
success
enum<boolean>
required

Always true when the HTTP status is 2xx.

Available options:
true
​
data
object
required