Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Monit Rs Badges API
version: 2026.08.30
contact:
name: monit.rs support
url: https://monit.rs/contact
email: support@monit.rs
license:
name: Data licensed for direct reuse; see terms
url: https://monit.rs/terms
termsOfService: https://monit.rs/terms
x-logo:
url: https://monit.rs/logo.png
backgroundColor: '#0f172a'
altText: monit.rs
x-origin:
- url: https://monit.rs/openapi.yaml
format: openapi
version: '3.1'
x-providerName: monit.rs
description: 'Operations tagged Badges across 2 of this provider''s published API definitions: api.monit.rs-openapi.json, monit-rs-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://monit.rs
description: Production
tags:
- name: Badges
description: Shields.io-compatible SVG badges for embedding in READMEs.
paths:
/badge/stability/{slug}.svg:
get:
tags:
- Badges
summary: Stability badge (shields.io-compatible SVG)
description: Returns an SVG stability badge for a tracked API, colored by the number of breaking changes detected in the last 90 days. Long Cache-Control header — safe to hotlink from a README.
operationId: getStabilityBadge
parameters:
- name: slug
in: path
required: true
schema:
type: string
pattern: ^[a-z0-9][a-z0-9-]{0,63}$
responses:
'200':
description: SVG badge
content:
image/svg+xml:
schema:
type: string
'404':
description: Unknown slug.
servers:
- url: https://monit.rs
description: Production
/badge/{slug}.svg:
get:
tags:
- Badges
summary: Status badge for a published status page (apex shortcut)
description: 'Shorthand for /api/v1/public/status/{slug}/badge.svg, which is the canonical route. The slug is a published STATUS PAGE slug, not a tracked-API slug: for a tracked vendor''s stability badge use /badge/stability/{slug}.svg instead. Exists purely so the URL is short enough to paste into a README.'
parameters:
- name: slug
in: path
required: true
description: Published status-page slug.
schema:
type: string
responses:
'200':
description: SVG image.
content:
image/svg+xml:
schema:
type: string
'404':
description: No published status page with that slug.
operationId: getBadge{slug}Svg
x-operation-id-source: derived
servers:
- url: https://monit.rs
description: Production
components:
securitySchemes:
ApiKeyBearer:
type: http
scheme: bearer
bearerFormat: mrs_live_*
description: monit.rs API key (mrs_live_ prefix). Get one at https://monit.rs/settings?tab=api-keys after signing in.
BearerJwt:
type: http
scheme: bearer
description: Bearer JWT token for authenticated user sessions.
externalDocs:
description: Full public site + browsable changelog
url: https://monit.rs/changelog
x-refined-from:
- api.monit.rs-openapi.json
- monit-rs-openapi.json