---
title: "Describe export capabilities for the authorized account."
method: GET
path: "/v1/finops/capabilities"
tags: ["FinOps"]
---

# Describe export capabilities for the authorized account.

`GET /v1/finops/capabilities`

## Request

- Base URL: `https://api.provider.example`
- URL: `https://api.provider.example/v1/finops/capabilities`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://provider.example/oauth/authorize`
    - Token URL: `https://provider.example/oauth/token` scopes: `billing.account.read`, `billing.usage.read`

## Response `200`

Account-specific provider capabilities.

- Capabilities
  - `profile_version` '0.1', required
  - `focus_version` '1.4', required
  - `provider` string, required
  - `authorization_methods` AuthorizationMethod[], required
  - `protected_resource_metadata_url` string, uri, nullable
  - `datasets` object, required
    - `usage` DatasetCapabilities, required
      - `endpoint` string, required
      - `granularities` Granularity[], required
      - `retention_days` integer, required
      - `maximum_window_days` integer, required
      - `freshness_lag_minutes` integer
      - `settlement_lag_hours` integer
      - `dimensions` Dimension[], required
      - `currencies` string[]
    - `costs` DatasetCapabilities
      - `endpoint` string, required
      - `granularities` Granularity[], required
      - `retention_days` integer, required
      - `maximum_window_days` integer, required
      - `freshness_lag_minutes` integer
      - `settlement_lag_hours` integer
      - `dimensions` Dimension[], required
      - `currencies` string[]

## Other responses

- `401`: Missing or invalid credential.
- `403`: Valid credential without the required scope or account access.
- `429`: Provider rate limit exceeded.

---

[API](https://skmtc.dev/superpenguin/apis/superpenguin-focus-ai-provider-profile.md) - [All operations](https://skmtc.dev/superpenguin/apis/superpenguin-focus-ai-provider-profile/llms.txt) - [OpenAPI document](https://skmtc.dev/superpenguin/apis/superpenguin-focus-ai-provider-profile/revisions/37d822e68d01?raw)
