curl --request GET \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/views \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/views', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"views": [
{
"id": "22222222-2222-4222-8222-222222222222",
"name": "Engineering activity",
"createdAt": "2026-01-01T10:00:00.000Z",
"updatedAt": "2026-01-01T10:00:00.000Z",
"version": 1,
"creator": {
"id": "employee-morgan",
"firstName": "Morgan",
"lastName": "Lee",
"avatarUrl": null,
"archivedAt": null
},
"sharingAccess": {
"companyAccess": "read",
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
],
"groupAccess": [
{
"groupId": "group-engineering",
"access": "read"
}
],
"automationAccess": [],
"subtreeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
],
"allManagersAccess": "read",
"capabilitiesAccess": []
},
"isOwner": true,
"canWrite": true
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"hasMore": false,
"total": 1
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}List stat views
Lists active saved stat views the caller owns or can read through sharing. Views store stat selections and employee filters, rather than snapshots of stat values. Results are ordered by case-insensitive name, then view ID. Pagination starts at page 1 with 20 views per page by default and at most 100. Request include.total to add the matching count as pagination.total. Requires access to Analytics in the workspace. Sharing a view shares its saved selections; each viewer can still read only the employee stats their own permissions allow.
curl --request GET \
--url https://api.gowindmill.com/api/v2/c/{companyId}/stats/views \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.gowindmill.com/api/v2/c/{companyId}/stats/views', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gowindmill.com/api/v2/c/{companyId}/stats/views"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gowindmill.com/api/v2/c/{companyId}/stats/views")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"views": [
{
"id": "22222222-2222-4222-8222-222222222222",
"name": "Engineering activity",
"createdAt": "2026-01-01T10:00:00.000Z",
"updatedAt": "2026-01-01T10:00:00.000Z",
"version": 1,
"creator": {
"id": "employee-morgan",
"firstName": "Morgan",
"lastName": "Lee",
"avatarUrl": null,
"archivedAt": null
},
"sharingAccess": {
"companyAccess": "read",
"employeeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
],
"groupAccess": [
{
"groupId": "group-engineering",
"access": "read"
}
],
"automationAccess": [],
"subtreeAccess": [
{
"employeeId": "employee-avery",
"access": "read"
}
],
"allManagersAccess": "read",
"capabilitiesAccess": []
},
"isOwner": true,
"canWrite": true
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"hasMore": false,
"total": 1
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "<string>",
"requestId": "<string>"
}
}Authorizations
Use an API key or OAuth access token. Enter only the token in the authorization dialog; requests send it as Authorization: Bearer <TOKEN>.
Create an API key in your workspace's Settings → API keys. Keys start with wm_api_ and only work in the workspace where they were created. Read-only keys can read data; creating, updating, or deleting data requires a read-write key.
Authorization: Bearer wm_api_example
OAuth access tokens are issued for connected Windmill applications.
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Both token types use the authenticated user's workspace permissions. Each endpoint's permission requirements and the sharing settings of the requested items still apply.
Path Parameters
Query Parameters
Response
Accessible stat views in deterministic name order
Was this page helpful?