Skip to main content
GET
/
virtual_tag_configs
/
{token}
Get virtual tag config by token
curl --request GET \
  --url https://api.vantage.sh/v2/virtual_tag_configs/{token} \
  --header 'Authorization: Bearer <token>'
{
  "token": "vtag_9cefbbc5f17d06fc",
  "created_by_token": "usr_f8c083243325740b",
  "key": "Product Team",
  "overridable": false,
  "backfill_until": "2024-07-01",
  "values": [
    {
      "filter": "(costs.provider = 'aws' AND costs.service = 'Amazon Elastic Compute Cloud') AND (costs.provider = 'aws' AND costs.account_id IN ('1234', '5678'))",
      "name": "Growth"
    },
    {
      "filter": "(costs.provider = 'aws' AND costs.account_id IN ('1234', '5678')) OR (costs.provider = 'gcp' AND costs.service = 'Google Compute Engine')",
      "name": "API"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
token
string
required

Response

VirtualTagConfig model

​
token
string

The token of the VirtualTagConfig.

Example:

"vtag_1234"

​
created_by_token
string

The token of the Creator of the VirtualTagConfig.

Example:

"usr_1234"

​
key
string

The key of the VirtualTagConfig.

Example:

"Cost Center"

​
overridable
boolean

Whether the VirtualTagConfig can override a provider-supplied tag on a matching Cost.

​
backfill_until
string

The earliest month VirtualTagConfig should be backfilled to.

Example:

"2025-07-01"

​
collapsed_tag_keys
object[]

Tag keys to collapse values for.

​
values
object[]

Values for the VirtualTagConfig, with match precedence determined by their relative order in the list.