How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Api Evangelist

API Evangelist Governance & Discovery API

Governance and discovery compute over the API Evangelist rule catalog — lint an OpenAPI against 461 curated rules or your own ruleset, score it, measure rule coverage, classify fields, diff versions, and validate onboarding. Free and keyless for the checking operations; artifact generation and estate rollups are Pro.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 26 operations across 26 paths, organized into 3 resource areas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.apievangelist.com/v1.

26 operations 26 paths 0 schemas 4 GET22 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.apievangelist.com/v1
Authentication
API Key
Contact
API Evangelist
Resource Areas
3

Authentication & Security 1

API Evangelist Governance & Discovery API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKey). By default, every request must be authenticated, though some operations may also be called without credentials.

  • ApiKey — A Pro or Team key from sign-in. Omit for keyless free-tier access.

Paths & Operations 26

Across 26 paths, the API surfaces 26 operations — 4 GET, 22 POST. They span 3 resource areas: Governance, Discovery, Account. Each is listed below with its method, path, parameters, and response codes.

Governance 19

Lint, coverage, waivers, reporting, certification, agent export, pipeline audit, toolsmith, context gate.

POST
/governance/validate
Lint an API artifact (FREE)
validate body → 200400422
POST
/governance/coverage
Governance coverage of a document (FREE)
coverage body → 200400
POST
/governance/waivers
Reconcile waivers against lint output (FREE)
waivers body → 200400
POST
/governance/report
Render a governance report (FREE HTML, Pro SARIF)
report 1 param body → 200402
POST
/governance/verify
Verify a governance certificate (FREE)
verify body → 200400
POST
/governance/classify
Classify PII and secret fields (FREE)
classify body → 200400
POST
/governance/diff
Detect breaking changes between two versions (FREE)
diff body → 200400
POST
/governance/scorecard
API maturity scorecard (FREE)
scorecard body → 200400
POST
/governance/deprecation
Deprecation / sunset posture (FREE)
deprecation body → 200400
POST
/governance/mock
Generate example payloads (PRO)
mock body → 200402
POST
/governance/snippets
Generate code samples (PRO)
snippets body → 200402
GET
/governance/rules
The curated rule catalog (FREE)
rules 1 param → 200
GET
/governance/rulesets
The Ruleset Commons registry (FREE)
rulesets → 200
POST
/governance/certify
Issue a governance certificate (PRO)
certify body → 200402
POST
/governance/agent-export
Export agent-native governance artifacts (PRO)
agentExport body → 200402
POST
/governance/pipeline-audit
Audit a repo Spectral CI maturity (PRO)
pipelineAudit body → 200402
POST
/governance/toolsmith
Forge MCP tools and Agent Skills (PRO)
toolsmith body → 200402
POST
/governance/context-gate
Emit a governed agent surface (PRO)
contextGate body → 200402
POST
/governance/overlay
Apply an OpenAPI Overlay (PRO)
overlay body → 200402
Discovery 4

Reusability and experience (DX/AX) analysis across a set of APIs.

POST
/discovery/reusability
Reusability and duplication across APIs (PRO)
reusability body → 200402
POST
/discovery/onboarding
Validate an API Onboarding Descriptor (FREE)
onboarding body → 200400
POST
/discovery/agent-descriptor
Generate llms.txt + AGENTS.md (PRO)
agentDescriptor body → 200402
POST
/discovery/experience
DX/AX experience coverage (PRO)
experience body → 200402
Account 3

GitHub sign-in, API key, and Stripe self-serve billing.

GET
/auth/login
Sign in with GitHub
authLogin → 302
GET
/auth/me
Current account
authMe → 200401
POST
/billing/checkout
Start a Pro/Team checkout
billingCheckout → 200401

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

apievangelist-governance-openapi.json Raw ↑
#Governance#Spectral#Linting#Discovery
← Back to A APIs
API Details
ID
api-evangelist:api-evangelist-governance-discovery-api
Base URL
https://api.apievangelist.com/v1
Docs
https://developer.apievangelist.com
Provider
Api Evangelist
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=api-evangelist-api-evangelist-governance-discovery-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/api-evangelist-api-evangelist-governance-discovery-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of API Evangelist Governance & Discovery API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.