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>'
{
  "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": {
      "dateGrouping": "daily",
      "dimension": "<string>"
    },
    "metric": "<string>",
    "comparisonEnabled": true,
    "metadata": {
      "name": "<string>",
      "description": "<string>"
    }
  }
}

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

​
filterConfiguration
object