Thanos website screenshot

Thanos

Open-source, highly available Prometheus setup with long-term storage capabilities that provides a global query view across multiple Prometheus servers.

Thanos publishes 10 APIs on the APIs.io network, including Alerts API, Blocks API, Health API, and 7 more. Tagged areas include Metrics, Monitoring, Observability, Prometheus, and Time Series Database.

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

Thanos’ developer surface includes getting-started guide, documentation, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub
44.9/100 developing ▬ flat Agent 32/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFree
10 APIs
MetricsMonitoringObservabilityPrometheusTime Series Database

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 44.9/100 · developing
Contract Quality 16.4 / 25
Developer Ergonomics 4.8 / 20
Commercial Clarity 5.8 / 20
Operational Transparency 3.4 / 13
Governance 8.3 / 12
Discoverability 6.3 / 10
Agent readiness — 32/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 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/thanos: 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 10

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

Thanos Alerts API

Endpoints for querying currently active alerts.

Thanos Blocks API

Block metadata inspection and compaction status endpoints.

Thanos Health API

Liveness and readiness probes for the Compactor.

Thanos Metadata API

The Metadata API from Thanos — 3 operation(s) for metadata.

Thanos Metrics API

Prometheus metrics for monitoring Compactor performance.

Thanos Query API

The Query API from Thanos — 2 operation(s) for query.

Thanos Remote Write API

Prometheus Remote Write ingestion endpoint.

Thanos Rules API

The Rules API from Thanos — 2 operation(s) for rules.

Thanos Stores API

The Stores API from Thanos — 1 operation(s) for stores.

Thanos Targets API

The Targets API from Thanos — 1 operation(s) for targets.

Scroll for all 10

Open Collections 6

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

Thanos Compact API

OPEN COLLECTION

Thanos Query API

OPEN COLLECTION

Thanos Receive API

OPEN COLLECTION

Thanos Ruler API

OPEN COLLECTION

Thanos Sidecar API

OPEN COLLECTION

Thanos Store Gateway API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Thanos Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Thanos Rate Limits

1 limits

RATE LIMITS

FinOps 1

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

Thanos Finops

FINOPS

Semantic Vocabularies 1

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

Thanos Context

0 classes · 10 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Thanos API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Thanos API Rules

8 rules · 1 errors 7 warnings

SPECTRAL

JSON Schema 23

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

Thanos Query Response

5 properties

JSON SCHEMA

Thanos Store Info

7 properties

JSON SCHEMA

ActiveTarget

9 properties

JSON SCHEMA

Alert

5 properties

JSON SCHEMA

AlertingRule

12 properties

JSON SCHEMA

AlertsResponse

2 properties

JSON SCHEMA

BlockMeta

5 properties

JSON SCHEMA

BlocksResponse

2 properties

JSON SCHEMA

DroppedTarget

1 properties

JSON SCHEMA

ErrorResponse

2 properties

JSON SCHEMA

LabelsResponse

3 properties

JSON SCHEMA

LabelValuesResponse

3 properties

JSON SCHEMA

MatrixResult

2 properties

JSON SCHEMA

QueryResponse

3 properties

JSON SCHEMA

RecordingRule

8 properties

JSON SCHEMA

RuleGroup

5 properties

JSON SCHEMA

RulesResponse

2 properties

JSON SCHEMA

ScalarResult

0 properties

JSON SCHEMA

SeriesResponse

3 properties

JSON SCHEMA

StoreInfo

7 properties

JSON SCHEMA

StoresResponse

2 properties

JSON SCHEMA

TargetsResponse

2 properties

JSON SCHEMA

VectorResult

2 properties

JSON SCHEMA

Scroll for all 23

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Thanos Query Structure

0 properties

JSON STRUCTURE

Thanos Structure

0 properties

JSON STRUCTURE

Examples 3

Example request and response payloads for these APIs.

Thanos Query Get Stores Example

2 fields

EXAMPLE

Thanos Query Instant Query Example

2 fields

EXAMPLE

Thanos Query Range Query Example

2 fields

EXAMPLE

Security Posture 1

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

Thanos Domain Security

TLSv1.3 · HSTS

SECURITY

Agentic Access 1

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

Thanos Agentic Access

31 operations · 3 acting

31 operations · 3 acting

AGENTIC

Resources

Get Started 1

Portal, sign-up, and the first successful call

GettingStarted
GettingStarted

Documentation 3

Reference material describing how the API behaves

JSONSchema
JSONSchema
 JSONSchema
JSONSchema
 Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 4

Pagination, idempotency, versioning, errors, and events

JSONLD
JSONLD
 JSONStructure
JSONStructure
 SpectralRules
SpectralRules
 Vocabulary
Vocabulary

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubRepository
GitHubRepository
 GitHubOrganization
GitHubOrganization

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Community
Community

Commercial 1

Pricing, plans, and the legal terms of use

License
License

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

Troubleshooting
Troubleshooting

Source (apis.yml)

apis.yml Raw ↑ 
aid: thanos
name: Thanos
description: Open-source, highly available Prometheus setup with long-term storage capabilities that provides a global query
  view across multiple Prometheus servers.
url: https://thanos.io/
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/thanos.png
tags:
- Metrics
- Monitoring
- Observability
- Prometheus
- Time Series Database
created: '2025'
modified: '2026-05-19'
type: Index
apis:
- aid: thanos:thanos-alerts-api
  name: Thanos Alerts API
  description: Endpoints for querying currently active alerts.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Alerts
  properties:
  - type: OpenAPI
    url: openapi/thanos-alerts-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-blocks-api
  name: Thanos Blocks API
  description: Block metadata inspection and compaction status endpoints.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Blocks
  properties:
  - type: OpenAPI
    url: openapi/thanos-blocks-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-health-api
  name: Thanos Health API
  description: Liveness and readiness probes for the Compactor.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Health
  properties:
  - type: OpenAPI
    url: openapi/thanos-health-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-metadata-api
  name: Thanos Metadata API
  description: The Metadata API from Thanos — 3 operation(s) for metadata.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Metadata
  properties:
  - type: OpenAPI
    url: openapi/thanos-metadata-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-metrics-api
  name: Thanos Metrics API
  description: Prometheus metrics for monitoring Compactor performance.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Metrics
  properties:
  - type: OpenAPI
    url: openapi/thanos-metrics-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-query-api
  name: Thanos Query API
  description: The Query API from Thanos — 2 operation(s) for query.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Query
  properties:
  - type: OpenAPI
    url: openapi/thanos-query-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-remote-write-api
  name: Thanos Remote Write API
  description: Prometheus Remote Write ingestion endpoint.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Remote Write
  properties:
  - type: OpenAPI
    url: openapi/thanos-remote-write-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-rules-api
  name: Thanos Rules API
  description: The Rules API from Thanos — 2 operation(s) for rules.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Rules
  properties:
  - type: OpenAPI
    url: openapi/thanos-rules-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-stores-api
  name: Thanos Stores API
  description: The Stores API from Thanos — 1 operation(s) for stores.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Stores
  properties:
  - type: OpenAPI
    url: openapi/thanos-stores-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
- aid: thanos:thanos-targets-api
  name: Thanos Targets API
  description: The Targets API from Thanos — 1 operation(s) for targets.
  humanURL: https://thanos.io/tip/components/query.md/
  baseURL: http://localhost:9090
  tags:
  - Targets
  properties:
  - type: OpenAPI
    url: openapi/thanos-targets-api-openapi.yml
  - type: Documentation
    url: https://thanos.io/tip/components/query.md/
  - type: JSONSchema
    url: json-schema/query-response.json
  - type: JSONSchema
    url: json-schema/store-info.json
  - type: JSONLD
    url: json-ld/thanos-context.jsonld
  - type: Documentation
    url: https://thanos.io/tip/components/store.md/
  - type: Documentation
    url: https://thanos.io/tip/components/sidecar.md/
  - type: Documentation
    url: https://thanos.io/tip/components/rule.md/
  - type: Documentation
    url: https://thanos.io/tip/components/receive.md/
  - type: Documentation
    url: https://thanos.io/tip/components/compact.md/
common:
- type: AgenticAccess
  url: agentic-access/thanos-agentic-access.yml
- type: DomainSecurity
  url: security/thanos-domain-security.yml
- url: https://thanos.io/
  type: Website
- url: json-ld/thanos-context.jsonld
  type: JSONLD
- url: json-schema/query-response.json
  type: JSONSchema
- url: json-schema/store-info.json
  type: JSONSchema
- url: json-structure/thanos-query-structure.json
  type: JSONStructure
- url: rules/thanos-rules.yml
  type: SpectralRules
- url: vocabulary/thanos-vocabulary.yml
  type: Vocabulary
- url: https://thanos.io/tip/thanos/getting-started.md/
  type: GettingStarted
- url: https://thanos.io/tip/
  type: Documentation
- url: https://github.com/thanos-io/thanos
  type: GitHubRepository
- url: https://github.com/thanos-io
  type: GitHubOrganization
- url: https://thanos.io/tip/contributing/community.md/
  type: Community
- url: https://thanos.io/tip/operating/troubleshooting.md/
  type: Troubleshooting
- url: https://www.apache.org/licenses/LICENSE-2.0
  type: License
maintainers:
- FN: Kin Lane
  url: http://apievangelist.com
  email: kin@apievangelist.com