GET
/
v0
/
tags
List all tags
curl --request GET \
  --url https://api.sandbox.teal.dev/v0/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'teal-instance-id: <teal-instance-id>'
{
  "next_page_token": "ikal0NEVfMhF8dJf4yQ6KQZmGD",
  "prev_page_token": "vuA7JeKI5c6FLnPt5JfRcZcJxW",
  "records": [
    {
      "enabled": true,
      "id": "UjL3BQnEaJtecuC7CUeDk",
      "name": "Sprinter - 1ab-c23",
      "tag_group_id": "NCB2xo5S1yQbNgyWskXpwG",
      "tag_group_name": "Delivery vehicles"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
teal-instance-id
string
required

The teal instance ID

Query Parameters

​
name
string | null

Optional name of tag for filtering.

​
tag_group_id
string | null

Optional tag group ID for filtering.

​
include_disabled
boolean
default:false

Include disabled tags.

​
sort
enum<string>[] | null

A comma separated list of sort orders for the results.

​
limit
integer | null
default:50

The number of records to return. Max limit is 1000.

Required range: 1 <= x < 1001
​
page_token
string | null

Response

Successful Response

​
next_page_token
string | null
required

The token to use to request the next page

Examples:

"ikal0NEVfMhF8dJf4yQ6KQZmGD"

​
prev_page_token
string | null
required

The token to use to request the previous page

Examples:

"vuA7JeKI5c6FLnPt5JfRcZcJxW"

​
records
EnhancedTag · object[]
required

A list of tags.

Examples:
[
  {
    "enabled": true,
    "id": "UjL3BQnEaJtecuC7CUeDk",
    "name": "Sprinter - 1ab-c23",
    "tag_group_id": "NCB2xo5S1yQbNgyWskXpwG",
    "tag_group_name": "Delivery vehicles"
  }
]