List all stacks
curl --request GET \
--url https://statusstack.com/api/v1/stacks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://statusstack.com/api/v1/stacks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://statusstack.com/api/v1/stacks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"stack_type": "application",
"visibility": "public",
"public_url": "<string>",
"theme": "auto",
"layout": "grid",
"custom_logo_url": "<string>",
"refresh_interval": 30,
"show_timestamps": true,
"show_component_names": true,
"show_incident_history": true,
"incident_history_days": 123,
"metadata": {},
"settings": {},
"view_count": 123,
"subscriber_count": 123,
"health_percentage": 123,
"sources_count": 123,
"components_count": 123,
"active_subscribers_count": 123,
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parent_stack_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"team": {},
"parent_stack": "<unknown>",
"child_stacks": "<array>",
"sources": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"type": "salesforce",
"url": "<string>",
"components": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_status": "operational",
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"components": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_status": "operational",
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"links": {
"self": "<string>",
"public": "<string>"
}
}
],
"meta": {
"current_page": 123,
"from": 123,
"to": 123,
"per_page": 123,
"total": 123,
"last_page": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"prev": "<string>",
"next": "<string>"
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>",
"errors": {}
}Stacks
List all stacks
Returns the stacks in the team the API key is scoped to. Unscoped keys are rejected with 403 rather than falling back to a session team.
GET
/
v1
/
stacks
List all stacks
curl --request GET \
--url https://statusstack.com/api/v1/stacks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://statusstack.com/api/v1/stacks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://statusstack.com/api/v1/stacks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"slug": "<string>",
"description": "<string>",
"stack_type": "application",
"visibility": "public",
"public_url": "<string>",
"theme": "auto",
"layout": "grid",
"custom_logo_url": "<string>",
"refresh_interval": 30,
"show_timestamps": true,
"show_component_names": true,
"show_incident_history": true,
"incident_history_days": 123,
"metadata": {},
"settings": {},
"view_count": 123,
"subscriber_count": 123,
"health_percentage": 123,
"sources_count": 123,
"components_count": 123,
"active_subscribers_count": 123,
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parent_stack_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"team": {},
"parent_stack": "<unknown>",
"child_stacks": "<array>",
"sources": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"type": "salesforce",
"url": "<string>",
"components": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_status": "operational",
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"components": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"latest_status": "operational",
"description": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"links": {
"self": "<string>",
"public": "<string>"
}
}
],
"meta": {
"current_page": 123,
"from": 123,
"to": 123,
"per_page": 123,
"total": 123,
"last_page": 123
},
"links": {
"first": "<string>",
"last": "<string>",
"prev": "<string>",
"next": "<string>"
}
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>",
"errors": {}
}Authorizations
StatusStack authenticates requests with API keys, created via the dashboard with granular permissions (read, write, delete, admin, *).
API keys support version compatibility:
- v1 keys: Can only access v1 endpoints
- v2 keys: Can access both v1 and v2 endpoints
Available permissions:
read: View resources (GET requests)write: Create and update resources (POST, PUT requests)delete: Delete resources (DELETE requests)admin: Administrative access to all resources*: Wildcard permission (all actions allowed)
Query Parameters
Required range:
x >= 1Required range:
1 <= x <= 100What the stack groups together, as stored. status_page is legacy: it is never
selectable on create, and on update it is accepted only when it is already the
stack's current type.
Available options:
application, tech, business, custom, status_page Who may view the stack's public page. password requires a password on the
create/update request.
Available options:
public, private, password, unlisted Case-insensitive match against name or slug.
Available options:
created_at, updated_at, name, slug Available options:
asc, desc Was this page helpful?

