GunSpec

Content

Public, key-free reads for GunSpec editorial content: blog posts and the product changelog. Both return only published entries and support pagination and category filtering. Use them to embed news, release notes, or articles directly in your own app.

Optional AuthExplorer+

Contract status badge

The latest run's verdict as an SVG badge, for a README or a directory listing: green with the number of checks that passed, red with the number that failed, or grey when nothing has been run. Drawn by this API from the same record GET /v1/contract serves, so the badge and the page cannot disagree. Cached for five minutes.

GET/v1/contract/badge.svg

Explorer+

  • stringheader

    Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

  • string

    Which product to report: api for this REST API, mcp for the hosted MCP server, fitment for the attachment compatibility suite.

    Accepts
  • string

    Which environment's run to report. Production unless asked otherwise.

    Accepts
  • string

    The wording on the grey half. Defaults to api contract or mcp health. Bounded because it is drawn into an image.

    Max length
    40
    Example
  • string

    Set 0 to draw the badge without the mark, for a row of badges that carry their own.

    Accepts
    Example

  • 400VALIDATION_ERRORValidation error
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Full rate limits

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.