Better Stack website screenshot

Better Stack

Better Stack is a comprehensive infrastructure monitoring and observability platform that combines uptime monitoring, log management, incident management, status pages, and AI-powered site reliability tools. It helps teams identify and resolve website and server issues quickly by providing real-time alerting, detailed diagnostics, on-call scheduling, and public/private status pages.

Better Stack publishes 6 APIs on the APIs.io network, including Escalation Policies API, Heartbeats API, Incidents API, and 3 more. Tagged areas include Incidents, Logs, Monitoring, Platform, and Status.

The Better Stack catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Better Stack’s developer surface includes authentication, developer portal, getting-started guide, pricing, engineering blog, changelog, and 11 more developer resources.

🌐 Visit website 📡 Source on GitHub
58.2/100 strong ▼ -6.7 Agent 44/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs 10 Features 6 Use Cases
IncidentsLogsMonitoringPlatformStatusUptimeObservabilityOn-CallHeartbeats

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 58.2/100 · strong
Contract Quality 14.6 / 25
Developer Ergonomics 7.4 / 20
Commercial Clarity 11.6 / 20
Operational Transparency 8.9 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 44/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/better-stack: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Better Stack Escalation Policies API

Manage escalation policies and on-call schedules

Better Stack Heartbeats API

Manage heartbeat monitors for scheduled jobs and cron tasks

Better Stack Incidents API

Manage incidents and on-call alerting

Better Stack Monitors API

Manage uptime monitors for URLs, APIs, and services

Better Stack Status Pages API

Manage public and private status pages

Better Stack Team Members API

Manage team members and invitations

Postman Collections 6

Ready-to-run Postman collections for exercising this provider's APIs.

Better Stack Escalation Policies API

POSTMAN

Better Stack Escalation Policies Heartbeats API

POSTMAN

Better Stack Escalation Policies Incidents API

POSTMAN

Better Stack Escalation Policies Monitors API

POSTMAN

Better Stack Escalation Policies Status Pages API

POSTMAN

Better Stack Escalation Policies Team Members API

POSTMAN

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Better Stack API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Better Stack Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Better Stack Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Better Stack Finops

FINOPS

Features 10

Notable capabilities this provider offers.

Uptime Monitoring

Monitor URLs, APIs, and services for availability with checks from multiple global regions every 30 seconds.

Heartbeat Monitoring

Monitor scheduled jobs, cron tasks, and background workers by pinging a unique URL on each run.

Incident Management

Automatically create and manage incidents when monitors detect downtime, with acknowledgement and resolution workflows.

On-Call Scheduling

Configure escalation policies with multi-step notification sequences via phone, SMS, email, and push.

Status Pages

Create public and private status pages with custom domains, branding, and real-time component status.

Log Management

Collect, search, and visualize logs across your entire infrastructure stack.

AI SRE

AI-powered root cause analysis that automatically investigates incidents and suggests resolutions.

Infrastructure Monitoring

OpenTelemetry-native monitoring with dashboards for metrics and infrastructure health.

Terraform Provider

Manage Better Stack resources as code using the official Terraform provider.

MCP Server

Model Context Protocol server for integrating Better Stack with AI tools and agents.

Scroll for all 10

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Better Stack Context

43 classes · 48 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Better Stack API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Better Stack API Rules

43 rules · 13 errors 23 warnings 7 info

SPECTRAL

JSON Schema 38

Standalone JSON Schema definitions for this provider's data models.

AvailabilityResponse

1 properties

JSON SCHEMA

HeartbeatAttributes

12 properties

JSON SCHEMA

HeartbeatCreateRequest

7 properties

JSON SCHEMA

HeartbeatListResponse

2 properties

JSON SCHEMA

HeartbeatObject

3 properties

JSON SCHEMA

HeartbeatSingleResponse

1 properties

JSON SCHEMA

HeartbeatUpdateRequest

3 properties

JSON SCHEMA

IncidentAttributes

10 properties

JSON SCHEMA

IncidentCreateRequest

5 properties

JSON SCHEMA

IncidentListResponse

2 properties

JSON SCHEMA

IncidentObject

3 properties

JSON SCHEMA

IncidentSingleResponse

1 properties

JSON SCHEMA

MonitorAttributes

17 properties

JSON SCHEMA

MonitorCreateRequest

11 properties

JSON SCHEMA

MonitorListResponse

2 properties

JSON SCHEMA

MonitorObject

3 properties

JSON SCHEMA

MonitorSingleResponse

1 properties

JSON SCHEMA

MonitorUpdateRequest

8 properties

JSON SCHEMA

Pagination

4 properties

JSON SCHEMA

PolicyAttributes

7 properties

JSON SCHEMA

PolicyCreateRequest

3 properties

JSON SCHEMA

PolicyListResponse

2 properties

JSON SCHEMA

PolicyObject

3 properties

JSON SCHEMA

PolicySingleResponse

1 properties

JSON SCHEMA

PolicyStep

2 properties

JSON SCHEMA

PolicyUpdateRequest

3 properties

JSON SCHEMA

ResponseTimesResponse

1 properties

JSON SCHEMA

StatusPageAttributes

9 properties

JSON SCHEMA

StatusPageCreateRequest

5 properties

JSON SCHEMA

StatusPageListResponse

2 properties

JSON SCHEMA

StatusPageObject

3 properties

JSON SCHEMA

StatusPageSingleResponse

1 properties

JSON SCHEMA

StatusPageUpdateRequest

3 properties

JSON SCHEMA

TeamMemberAttributes

5 properties

JSON SCHEMA

TeamMemberInviteRequest

2 properties

JSON SCHEMA

TeamMemberListResponse

2 properties

JSON SCHEMA

TeamMemberObject

3 properties

JSON SCHEMA

TeamMemberSingleResponse

1 properties

JSON SCHEMA

Scroll for all 38

JSON Structure 38

JSON Structure definitions describing this provider's data shapes.

Better Stack Availability Response Structure

1 properties

JSON STRUCTURE

Better Stack Heartbeat Attributes Structure

12 properties

JSON STRUCTURE

Better Stack Heartbeat Create Request Structure

7 properties

JSON STRUCTURE

Better Stack Heartbeat List Response Structure

2 properties

JSON STRUCTURE

Better Stack Heartbeat Object Structure

3 properties

JSON STRUCTURE

Better Stack Heartbeat Single Response Structure

1 properties

JSON STRUCTURE

Better Stack Heartbeat Update Request Structure

3 properties

JSON STRUCTURE

Better Stack Incident Attributes Structure

10 properties

JSON STRUCTURE

Better Stack Incident Create Request Structure

5 properties

JSON STRUCTURE

Better Stack Incident List Response Structure

2 properties

JSON STRUCTURE

Better Stack Incident Object Structure

3 properties

JSON STRUCTURE

Better Stack Incident Single Response Structure

1 properties

JSON STRUCTURE

Better Stack Monitor Attributes Structure

17 properties

JSON STRUCTURE

Better Stack Monitor Create Request Structure

11 properties

JSON STRUCTURE

Better Stack Monitor List Response Structure

2 properties

JSON STRUCTURE

Better Stack Monitor Object Structure

3 properties

JSON STRUCTURE

Better Stack Monitor Single Response Structure

1 properties

JSON STRUCTURE

Better Stack Monitor Update Request Structure

8 properties

JSON STRUCTURE

Better Stack Pagination Structure

4 properties

JSON STRUCTURE

Better Stack Policy Attributes Structure

7 properties

JSON STRUCTURE

Better Stack Policy Create Request Structure

3 properties

JSON STRUCTURE

Better Stack Policy List Response Structure

2 properties

JSON STRUCTURE

Better Stack Policy Object Structure

3 properties

JSON STRUCTURE

Better Stack Policy Single Response Structure

1 properties

JSON STRUCTURE

Better Stack Policy Step Structure

2 properties

JSON STRUCTURE

Better Stack Policy Update Request Structure

3 properties

JSON STRUCTURE

Better Stack Response Times Response Structure

1 properties

JSON STRUCTURE

Better Stack Status Page Attributes Structure

9 properties

JSON STRUCTURE

Better Stack Status Page Create Request Structure

5 properties

JSON STRUCTURE

Better Stack Status Page List Response Structure

2 properties

JSON STRUCTURE

Better Stack Status Page Object Structure

3 properties

JSON STRUCTURE

Better Stack Status Page Single Response Structure

1 properties

JSON STRUCTURE

Better Stack Status Page Update Request Structure

3 properties

JSON STRUCTURE

Better Stack Team Member Attributes Structure

5 properties

JSON STRUCTURE

Better Stack Team Member Invite Request Structure

2 properties

JSON STRUCTURE

Better Stack Team Member List Response Structure

2 properties

JSON STRUCTURE

Better Stack Team Member Object Structure

3 properties

JSON STRUCTURE

Better Stack Team Member Single Response Structure

1 properties

JSON STRUCTURE

Scroll for all 38

Examples 38

Example request and response payloads for these APIs.

Better Stack Availability Response Example

1 fields

EXAMPLE

Better Stack Heartbeat Attributes Example

12 fields

EXAMPLE

Better Stack Heartbeat Create Request Example

7 fields

EXAMPLE

Better Stack Heartbeat List Response Example

2 fields

EXAMPLE

Better Stack Heartbeat Object Example

3 fields

EXAMPLE

Better Stack Heartbeat Single Response Example

1 fields

EXAMPLE

Better Stack Heartbeat Update Request Example

3 fields

EXAMPLE

Better Stack Incident Attributes Example

10 fields

EXAMPLE

Better Stack Incident Create Request Example

5 fields

EXAMPLE

Better Stack Incident List Response Example

2 fields

EXAMPLE

Better Stack Incident Object Example

3 fields

EXAMPLE

Better Stack Incident Single Response Example

1 fields

EXAMPLE

Better Stack Monitor Attributes Example

17 fields

EXAMPLE

Better Stack Monitor Create Request Example

11 fields

EXAMPLE

Better Stack Monitor List Response Example

2 fields

EXAMPLE

Better Stack Monitor Object Example

3 fields

EXAMPLE

Better Stack Monitor Single Response Example

1 fields

EXAMPLE

Better Stack Monitor Update Request Example

8 fields

EXAMPLE

Better Stack Pagination Example

4 fields

EXAMPLE

Better Stack Policy Attributes Example

7 fields

EXAMPLE

Better Stack Policy Create Request Example

3 fields

EXAMPLE

Better Stack Policy List Response Example

2 fields

EXAMPLE

Better Stack Policy Object Example

3 fields

EXAMPLE

Better Stack Policy Single Response Example

1 fields

EXAMPLE

Better Stack Policy Step Example

2 fields

EXAMPLE

Better Stack Policy Update Request Example

3 fields

EXAMPLE

Better Stack Response Times Response Example

1 fields

EXAMPLE

Better Stack Status Page Attributes Example

9 fields

EXAMPLE

Better Stack Status Page Create Request Example

5 fields

EXAMPLE

Better Stack Status Page List Response Example

2 fields

EXAMPLE

Better Stack Status Page Object Example

3 fields

EXAMPLE

Better Stack Status Page Single Response Example

1 fields

EXAMPLE

Better Stack Status Page Update Request Example

3 fields

EXAMPLE

Better Stack Team Member Attributes Example

5 fields

EXAMPLE

Better Stack Team Member Invite Request Example

2 fields

EXAMPLE

Better Stack Team Member List Response Example

2 fields

EXAMPLE

Better Stack Team Member Object Example

3 fields

EXAMPLE

Better Stack Team Member Single Response Example

1 fields

EXAMPLE

Scroll for all 38

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Better Stack Authentication

http · 1 scheme

SECURITY

Better Stack Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Better Stack Vulnerability Disclosure

disclosure policy published

SECURITY

Better Stack Trust Center

SOC 2, ISO 27001, HIPAA, GDPR

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Better Stack Agentic Access

33 operations · 18 acting

33 operations · 18 acting

AGENTIC

Use Cases 6

What developers build with this provider.

Website Uptime Monitoring

Monitor public websites and APIs for availability and alert on-call engineers when they go down.

API Health Checking

Continuously verify that REST APIs return expected status codes and response times.

Cron Job Monitoring

Use heartbeats to ensure scheduled tasks run on time and alert when they fail to check in.

Incident Response Automation

Automate incident creation, on-call notifications, and resolution workflows to reduce MTTR.

Customer-Facing Status Communication

Publish status pages that automatically reflect the real-time health of monitored services.

Infrastructure Observability

Aggregate logs, metrics, and traces in a single platform for full-stack observability.

Integrations 6

Pre-built integrations with other platforms and tools.

Slack

Receive incident alerts and status updates directly in Slack channels.

PagerDuty

Forward incidents to PagerDuty for existing on-call workflows.

Terraform

Manage monitors, status pages, and escalation policies as infrastructure as code.

OpenTelemetry

Send metrics, logs, and traces using OpenTelemetry-compatible exporters.

Sentry

Compatible with Sentry SDK for error tracking integration.

New Relic

Connect Better Stack monitoring data with New Relic dashboards.

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal
Portal
 GettingStarted
GettingStarted

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

SpectralRules
SpectralRules
 Vocabulary
Vocabulary

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace
PostmanWorkspace
 GitHubOrganization
GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

StatusPage
StatusPage
 ChangeLog
ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

Pricing
Pricing

Company 2

The organization behind the API

LinkedIn
LinkedIn
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: better-stack
url: https://raw.githubusercontent.com/api-evangelist/better-stack/refs/heads/main/apis.yml
apis:
- aid: better-stack:better-stack-escalation-policies-api
  name: Better Stack Escalation Policies API
  description: Manage escalation policies and on-call schedules
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Escalation Policies
  properties:
  - type: OpenAPI
    url: openapi/better-stack-escalation-policies-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
- aid: better-stack:better-stack-heartbeats-api
  name: Better Stack Heartbeats API
  description: Manage heartbeat monitors for scheduled jobs and cron tasks
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Heartbeats
  properties:
  - type: OpenAPI
    url: openapi/better-stack-heartbeats-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
- aid: better-stack:better-stack-incidents-api
  name: Better Stack Incidents API
  description: Manage incidents and on-call alerting
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Incidents
  properties:
  - type: OpenAPI
    url: openapi/better-stack-incidents-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
- aid: better-stack:better-stack-monitors-api
  name: Better Stack Monitors API
  description: Manage uptime monitors for URLs, APIs, and services
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Monitors
  properties:
  - type: OpenAPI
    url: openapi/better-stack-monitors-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
- aid: better-stack:better-stack-status-pages-api
  name: Better Stack Status Pages API
  description: Manage public and private status pages
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Status Pages
  properties:
  - type: OpenAPI
    url: openapi/better-stack-status-pages-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
- aid: better-stack:better-stack-team-members-api
  name: Better Stack Team Members API
  description: Manage team members and invitations
  humanURL: https://betterstack.com/docs/uptime/api/getting-started/
  baseURL: https://uptime.betterstack.com/api/v2
  tags:
  - Team Members
  properties:
  - type: OpenAPI
    url: openapi/better-stack-team-members-api-openapi.yml
  - type: Documentation
    url: https://betterstack.com/docs/uptime/api/getting-started/
  - type: APIReference
    url: https://betterstack.com/docs/uptime/api/monitors/
name: Better Stack
tags:
- Incidents
- Logs
- Monitoring
- Platform
- Status
- Uptime
- Observability
- On-Call
- Heartbeats
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/better-stack.png
access: 3rd-Party
created: '2025-01-08'
modified: '2026-05-19'
position: Consuming
description: Better Stack is a comprehensive infrastructure monitoring and observability platform that combines uptime monitoring,
  log management, incident management, status pages, and AI-powered site reliability tools. It helps teams identify and resolve
  website and server issues quickly by providing real-time alerting, detailed diagnostics, on-call scheduling, and public/private
  status pages.
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/better-stack/overview
- type: AgenticAccess
  url: agentic-access/better-stack-agentic-access.yml
- type: TrustCenter
  url: security/better-stack-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/better-stack-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/better-stack-domain-security.yml
- type: Authentication
  url: authentication/better-stack-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/betterstack
- type: Portal
  url: https://betterstack.com/docs/
- type: GettingStarted
  url: https://betterstack.com/docs/uptime/api/getting-started/
- type: Authentication
  url: https://betterstack.com/docs/uptime/api/getting-started/
- type: Pricing
  url: https://betterstack.com/pricing
- type: StatusPage
  url: https://status.betterstack.com/
- type: Blog
  url: https://betterstack.com/community/blog
- type: ChangeLog
  url: https://betterstack.com/tag/changelog
- type: GitHubOrganization
  url: https://github.com/BetterStackHQ
- type: SpectralRules
  url: https://raw.githubusercontent.com/api-evangelist/better-stack/refs/heads/main/rules/better-stack-spectral-rules.yml
- type: Vocabulary
  url: https://raw.githubusercontent.com/api-evangelist/better-stack/refs/heads/main/vocabulary/better-stack-vocabulary.yaml
- type: Features
  data:
  - name: Uptime Monitoring
    description: Monitor URLs, APIs, and services for availability with checks from multiple global regions every 30 seconds.
  - name: Heartbeat Monitoring
    description: Monitor scheduled jobs, cron tasks, and background workers by pinging a unique URL on each run.
  - name: Incident Management
    description: Automatically create and manage incidents when monitors detect downtime, with acknowledgement and resolution
      workflows.
  - name: On-Call Scheduling
    description: Configure escalation policies with multi-step notification sequences via phone, SMS, email, and push.
  - name: Status Pages
    description: Create public and private status pages with custom domains, branding, and real-time component status.
  - name: Log Management
    description: Collect, search, and visualize logs across your entire infrastructure stack.
  - name: AI SRE
    description: AI-powered root cause analysis that automatically investigates incidents and suggests resolutions.
  - name: Infrastructure Monitoring
    description: OpenTelemetry-native monitoring with dashboards for metrics and infrastructure health.
  - name: Terraform Provider
    description: Manage Better Stack resources as code using the official Terraform provider.
  - name: MCP Server
    description: Model Context Protocol server for integrating Better Stack with AI tools and agents.
- type: UseCases
  data:
  - name: Website Uptime Monitoring
    description: Monitor public websites and APIs for availability and alert on-call engineers when they go down.
  - name: API Health Checking
    description: Continuously verify that REST APIs return expected status codes and response times.
  - name: Cron Job Monitoring
    description: Use heartbeats to ensure scheduled tasks run on time and alert when they fail to check in.
  - name: Incident Response Automation
    description: Automate incident creation, on-call notifications, and resolution workflows to reduce MTTR.
  - name: Customer-Facing Status Communication
    description: Publish status pages that automatically reflect the real-time health of monitored services.
  - name: Infrastructure Observability
    description: Aggregate logs, metrics, and traces in a single platform for full-stack observability.
- type: Integrations
  data:
  - name: Slack
    description: Receive incident alerts and status updates directly in Slack channels.
  - name: PagerDuty
    description: Forward incidents to PagerDuty for existing on-call workflows.
  - name: Terraform
    description: Manage monitors, status pages, and escalation policies as infrastructure as code.
  - name: OpenTelemetry
    description: Send metrics, logs, and traces using OpenTelemetry-compatible exporters.
  - name: Sentry
    description: Compatible with Sentry SDK for error tracking integration.
  - name: New Relic
    description: Connect Better Stack monitoring data with New Relic dashboards.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.19'