Get All Tags - Profile Support Documentation

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"
      ]
    }
  ]
}

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