Skip to main content
GET
/
tags
List all tags on account
curl --request GET \
  --url https://vanguard.profilebehavior.com/api/v4/tags \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "tags": [
    {
      "id": "60e9ca73c500a9001534ad84",
      "createdAt": "2025-01-01T09:42:52.329056-05:00",
      "updatedAt": "2025-01-01T09:42:52.329056-05:00",
      "label": "Team",
      "color": "emerald",
      "profiles": [
        "6592008029c8c3e4dc76256c",
        "507f191e810c19729de860ea"
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer
default:10
required

The number of tags to retrieve per paginated request.

​
page
integer
default:1
required

The current page of results you are requesting. This indicates how many documents to skip based on the provided limit.

Response

Success

Standard response object for successful requests that return an array of resources. Used for list endpoints in the Profile Behavior API.

​
code
integer<int32>
required

HTTP status code of the successful response.

​
status
enum<string>

Always "success" for successful responses.

Available options:
success
​
tags
object[]