Skip to main content
GET
/
tags
/
{key}
/
values
Get tag values
curl --request GET \
  --url https://api.vantage.sh/v2/tags/{key}/values \
  --header 'Authorization: Bearer <token>'
{
  "tag_values": [
    {
      "tag_value": "production",
      "providers": [
        "aws",
        "azure",
        "custom_provider:accss_crdntl_3d5f465892a0718f"
      ]
    },
    {
      "tag_value": "staging",
      "providers": [
        "aws",
        "azure",
        "custom_provider:accss_crdntl_3d5f465892a0718f"
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
key
string
required

The key of the Tag for which you would like to retrieve TagValues.

Query Parameters

​
providers
enum<string>[]

An array of providers to scope TagValues by.

Available options:
aws,
azure,
gcp,
snowflake,
databricks,
mongo,
datadog,
fastly,
new_relic,
opencost,
open_ai,
oracle,
confluent,
planetscale,
coralogix,
kubernetes,
custom_provider,
github,
linode,
grafana,
clickhouse,
temporal,
twilio,
azure_csp,
kubernetes_agent,
anthropic,
anyscale,
cursor
​
sort_direction
enum<string>
default:asc

The direction in which to sort the TagValues. Defaults to 'asc'.

Available options:
asc,
desc
​
search_query
string

A search query to filter TagValues by the value name.

​
page
integer<int32>
default:1

The page of results to return.

​
limit
integer<int32>
default:100

The number of results to return per page. Defaults to 100. The maximum is 1000.

Response

TagValues model

​
tag_values
object[]