With an authenticated user it is possible to load the tagstatistics.
GET <cambuildr-url>/api/v1/tags/statistics
The Accept header has to be set to application/json for this route to work properly.
This returns the tag statistics (contacts that received a tag) grouped by day and name, as well as the count of people that received the tag on that day
{
"error": false,
"tags": [
{
"day": "2025-01-20",
"tag_name": "Tag #1",
"new_people_assigned_count": 1
},
{
"day": "2025-01-21",
"tag_name": "Tag #1",
"new_people_assigned_count": 1
},
{
"day": "2025-03-26",
"tag_name": "Tag #1",
"new_people_assigned_count": 1
},
{
"day": "2025-03-26",
"tag_name": "Tag #2",
"new_people_assigned_count": 2
}
]
}
By default, the statistics of the last 30 days are returned (also in the aggregation). The query parameters year and month (1-12) can be used to change this. month is only used, if a year is also defined.
For instance, GET <cambuildr-url>/api/v1/tags/statistics?year=2024&month=4 would only show the statistics from April 2024.
If the query-parameter format=csv is sent with the request, the data is returned as CSV:
day,tag_name,new_people_assigned_count
2025-01-20,"Tag #1",1
2025-01-21,"Tag #1",1
2025-03-18,"Tag #1",1
2025-03-26,"Tag #1",1
2025-03-26,"Tag #2",2