APIMatic is profiled on APIs.io from a single APIs.json file, apis.yml. APIMatic is a developer experience platform for APIs that specializes in automated SDK generation, API documentation portal creation, specification validation and linting, and API format transformation. The file indexes 5 APIs and 61 common properties. 64 Kin Score checks read this file, and it earns 145.8 of their 267 points. APIMatic scored 63.2 (strong) on 2026-11-05; the badge above is live and shows the current score.
What the file contains
- 7 tags: API Transformation, Code Generation, Developer Experience, Developer Tools, Documentation, SDK Generation, OpenAPI
- Specification version: 0.23
- Created: 2025-01-08
- Modified: 2026-09-23
- Maintainers: 1 listed
Common properties (50 types) apply across every API in the file:
AgenticAccess · AgentSkill · AgentSkills · APIReference · Authentication · Blog · ChangeLog · CLI · Components · Conformance · Conventions · DataModel · Deprecation · DeveloperPortal · Documentation · DomainSecurity · ErrorCatalog · Features · FinOps · GettingStarted · GitHubOrganization · Hosts · Integrations · JSONLD · Lifecycle · LinkedIn · LLMsTxt · Login · MCPServer · OAuthScopes · Packages · Plans · Pricing · PrivacyPolicy · RateLimits · Sandbox · SDKs · Signup · Solutions · Spectral · Support · TermsOfService · ToolCrosswalk · UseCases · VendorFacets · Vendors · Vocabulary · Website · WellKnown · X
APIs (5):
- APIMatic API Transformer API — Documentation
- APIMatic Portals API — Documentation, GettingStarted, OpenAPI
- APIMatic SDK Generation API — Documentation, GettingStarted, JSONSchema, OpenAPI
- APIMatic Transformation API — Documentation, GettingStarted, JSONSchema, OpenAPI
- APIMatic Validation API — Documentation, GettingStarted, JSONSchema, OpenAPI
How the file drives the Kin Score
64 checks in rubric 0.26.0 read this file. 32 are earned, 3 partly, and 29 are not.
| Check | Points | What it reads |
|---|---|---|
| Discoverability — 37 of 43 points | ||
| Publishes an apis.yml index | 10 / 10 | source_filename == "apis.yml" |
| Base URL on every API | 5 / 5 | every api has baseURL and no baseURL contains "localhost" |
| Human URL on every API | 5 / 5 | every api has humanURL |
| Substantive description | 5 / 5 | len(description) >= 200 |
| Tagged for discovery | 5 / 5 | len(tags) >= 5 |
| Named maintainer | 3 / 3 | maintainers[0].email is set |
| Created and modified dates | 2 / 2 | created and modified both ISO dates |
| Provider image | 2 / 2 | image is set |
| Contract governance — 1.2 of 5 points | ||
| Publishes a vocabulary | 1.2 / 5 | common[].type includes "Vocabulary" |
| Operational transparency — 10 of 26 points | ||
| Change log | 6 / 6 | common[].type includes "ChangeLog" (alias-aware) |
| Deprecation policy | 3 / 3 | common[].type includes "Deprecation" (alias-aware) |
| GitHub organization | 1 / 2 | common[].type includes "GitHubOrganization" or "GitHubRepository" (alias-aware) |
| Developer ergonomics — 40 of 42 points | ||
| Authentication documented | 5 / 5 | common[].type includes "Authentication" |
| Getting started guide | 5 / 5 | common[].type includes "GettingStarted" or "Quickstart" |
| Developer portal | 4 / 4 | common[].type includes "DeveloperPortal" (alias-aware) |
| Documentation | 4 / 4 | common[].type includes "Documentation" |
| Three or more SDKs | 4 / 4 | count(common[].type == "SDK" alias-aware) >= 3 |
| API reference | 3 / 3 | common[].type includes "APIReference" (alias-aware) |
| Agent Skill | 3 / 3 | common[].type includes "AgentSkill", graded by who authored it |
| At least one SDK | 3 / 3 | count(common[].type == "SDK" alias-aware) >= 1 |
| Command-line interface | 3 / 3 | common[].type includes "CLI" |
| Console or sandbox | 3 / 3 | common[].type includes "Console" or "Sandbox" or "Playground" |
| Support channel | 2 / 2 | common[].type includes "Support" or "HelpCenter" or "Community" |
| Blog | 1 / 1 | common[].type includes "Blog" |
| Access clarity — 14.5 of 23 points | ||
| Pricing published | 4 / 4 | common[].type includes "Pricing" |
| Privacy policy | 4 / 4 | common[].type includes "PrivacyPolicy" (alias-aware) |
| Terms of service | 4 / 4 | common[].type includes "TermsOfService" (alias-aware) |
| Self-service sign-up | 2.5 / 5 | common[].type includes "SignUp" or "Login" |
| Regulatory — 35 of 94 points | ||
| Consent-scoped authorization | 10 / 10 | common[].type includes "OAuthScopes" OR a scopes artifact is present |
| Authentication model documented | 6 / 6 | common[].type includes "Authentication" or "OpenIDConnect" |
| Security posture published | 6 / 6 | common[].type includes "Security" or "DomainSecurity" |
| Data-standard conformance | 5 / 5 | implements a recognized data standard — common[].type includes "Standard"/"Conformance", or a Vocabulary/JSON-LD context is published |
| Privacy policy (data handling) | 4 / 4 | common[].type includes "PrivacyPolicy" |
| Terms of service (legal basis) | 4 / 4 | common[].type includes "TermsOfService" |
| Agent readiness — 8 of 30 points | ||
| Stable Error Semantics | 8 / 8 | OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes |
What the file does not say yet
121.2 more points depend on entries this file does not have. A missing pointer means the file does not link to it. It does not mean APIMatic has not published it.
- Idempotency (9 pts) —
OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented) - Status page (6 pts) —
common[].type includes "StatusPage" - Typed Event Surface (6 pts) —
AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks - Vulnerability disclosure program (6 pts) —
common[].type includes "VulnerabilityDisclosure" - Compliance / certification disclosure (5 pts) —
common[].type includes "Compliance" or "TrustCenter" or "Trust" - Accessibility conformance report (4 pts) —
common[].type includes "AccessibilityConformance" - Age assurance (4 pts) —
common[].type includes "AgeAssurance" - Data residency statement (4 pts) —
common[].type includes "DataResidency" - Data-subject request route (4 pts) —
common[].type includes "DataSubjectRequest" - Declared support lifetime (4 pts) —
common[].type includes "SupportLifetime" - Exit assistance / switching terms (4 pts) —
common[].type includes "ExitAssistance" - Global Privacy Control honoured (4 pts) —
common[].type includes "GlobalPrivacyControl" - Incident notification commitment (4 pts) —
common[].type includes "IncidentNotification" - Notice-and-action mechanism (4 pts) —
common[].type includes "NoticeAndAction" - Published example corpus (4 pts) —
common[].type includes "Examples" (alias-aware: CodeExamples, Samples, CodeSamples, Demos) - Security disclosure (4 pts) —
common[].type includes "Security" (alias-aware) - Self-hosts the APIs.json index (4 pts) —
apis.yml url points at a host the provider controls, not the catalog - Software bill of materials (4 pts) —
common[].type includes "SBOM" - Subprocessor list (4 pts) —
common[].type includes "Subprocessors" - Transparency report (4 pts) —
common[].type includes "TransparencyReport" - Well-Known Catalog (4 pts) —
common[].type includes WellKnown, APICatalog, or api-catalog - Compliance published (3 pts) —
common[].type includes "Compliance" - Consent & Bot Identity (3 pts) —
common[].type includes AIPREF, ContentSignal, WebBotAuth, or HTTPMessageSignatures - Trust center (3 pts) —
common[].type includes "TrustCenter" or "Trust" - Webhooks advertised (3 pts) —
common[].type includes "Webhooks" - Postman collection (2 pts) —
common[].type includes "Postman" (alias-aware), graded by who authored it - Public roadmap (2 pts) —
common[].type includes "RoadMap" or "Roadmap" - Leadership page (1 pt) —
common[].type includes Leadership, LeadershipTeam, Management or ExecutiveTeam - Newsroom (1 pt) —
common[].type includes Newsroom, PressReleases, Press or News
Who keeps this file
API Evangelist maintains this file at github.com/api-evangelist/apimatic. If you work at APIMatic, you can open an issue or a pull request to add or correct an entry. You can also publish your own APIs.json at /.well-known/apis.json on your domain, which earns the self-hosting check and makes the file yours.
See the full rating on the APIMatic profile, and how every check is scored at apis.io/rating.