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>'
{
  "links": {
    "self": "https://api.vantage.sh/v2/tags/environment/values?sort_column=tag_value&sort_direction=asc",
    "first": "https://api.vantage.sh/v2/tags/environment/values?sort_column=tag_value&sort_direction=asc&page=1",
    "next": null,
    "last": null,
    "prev": null
  },
  "tag_values": [
    {
      "tag_value": "production",
      "providers": [
        "aws",
        "azure",
        "custom_provider:accss_crdntl_b180279f14faa5b7"
      ]
    },
    {
      "tag_value": "staging",
      "providers": [
        "aws",
        "azure",
        "custom_provider:accss_crdntl_b180279f14faa5b7"
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt

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

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,
elastic,
vercel,
redis_cloud,
circle_ci
​
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[]
required
​
links
object