Ratings
The APIs.io API rating system — a 0–100 composite score, five bands, a trend marker, and six weighted facets measuring how complete, governed, and integration-ready each provider's public API surface is. Rubric v0.3.
One provider's rating.
Returns the full rating breakdown for a single provider — composite, band, trend, delta, and all six facet scores.
path Parameters
slugProvider slug (e.g. twilio).
One provider's rating. › Responses
One provider's rating.
compositeWeighted composite of the six facets.
bandRating band derived from the composite score.
trendWeek-over-week movement in composite score (±5 thresholds).
deltaComposite change since the previous snapshot.
previous_compositescored_atschema_versionThe six facet scores, each 0–100.
Ranked ratings leaderboard.
Providers ranked by composite score, highest first. Filter by band, score range, trend, or a facet threshold (facet + min_facet), and scope to providers or tags. Each entry carries rank, composite, band, trend, and the six facet scores.
query Parameters
bandFilter by one or more rating bands.
min_scoreMinimum composite score (0–100).
max_scoreMaximum composite score (0–100).
trendFilter by trend marker.
Week-over-week movement in composite score (±5 thresholds).
facetFacet to apply min_facet against.
One of the six rating facets.
min_facetMinimum score (0–100) for the facet named by facet.
providersComma-separated provider slugs to scope results to.
tagsComma-separated tags to filter by. Tag names are Title Case (e.g. Messaging); lowercase slugs (e.g. messaging) are also accepted.
sortSort order (composite descending by default).
page1-based page number.
limitItems per page.
Ranked ratings leaderboard. › Responses
Ranked ratings leaderboard.
Pagination and echoed-query metadata for collection responses.
The rating rubric.
Returns the versioned rubric behind every score — the five bands and their thresholds, the six facets and their weights, and the trend thresholds. Use it to interpret any score block.
The rating rubric. › Responses
The rating rubric.
schema_versionA provider's rating movement.
Returns a provider's current score/band/trend and the implied previous-build point. apis.io stores the current score plus week-over-week movement, not a full time series.
path Parameters
slugProvider slug (e.g. twilio).
A provider's rating movement. › Responses
The provider's rating history.
One provider's score at facet depth (Pro).
The facets the composite is built from, plus any regulatory regime that applies and how it was matched. The composite is one number; these are the parts a team can act on.
path Parameters
slugProvider slug (e.g. twilio).
One provider's score at facet depth (Pro). › Responses
One provider's score at facet depth (Pro).
Agent-readiness dimensions (Pro).
The dimension-by-dimension agent readiness of one provider — spec presence, MCP server, auth clarity, idempotency, error semantics, rate-limit signal, well-known catalog, consent identity and the rest. A standalone score, not a slice of the composite.
path Parameters
slugProvider slug (e.g. twilio).
Agent-readiness dimensions (Pro). › Responses
Agent-readiness dimensions (Pro).
How the score was established.
Provenance for each part of a provider's score: first-party (they published it), verified (we fetched and confirmed it), or derived (we inferred it), plus contract coverage and callability. Free and deliberately ungated — the basis for a claim should never sit behind the claim. Call this before quoting or disputing a score.
path Parameters
slugProvider slug (e.g. twilio).
How the score was established. › Responses
How the score was established.
The agent-readiness leaderboard across the catalog.
Rank providers by agent readiness, and filter to those that DO satisfy (has) or do NOT satisfy (missing) specific dimensions — has=mcp_server,protected_resource_metadata is the OAuth-capable MCP cohort, missing=agent_card is the addressable market for a fix. ONE provider's own readiness stays free at /providers/{slug}/agent-readiness; this is the catalog-wide read.
query Parameters
hasComma-separated dimensions the provider must satisfy.
missingComma-separated dimensions the provider must NOT satisfy.
limitpageThe agent-readiness leaderboard across the catalog. › Responses
The leaderboard.
Ranked, costed remediation for one provider.
Which specific rubric checks a provider fails, what each is worth, and in what order to fix them. The free improve_my_score prompt names the weakest FACET; this names the check.
path Parameters
slugProvider slug (e.g. twilio).
Ranked, costed remediation for one provider. › Responses
The remediation plan.
Band gates before points.
Which bands a provider is gated out of regardless of score. Some bands are not reachable by collecting points at all, and a plan that ignores that spends engineering time for nothing.
path Parameters
slugProvider slug (e.g. twilio).
Band gates before points. › Responses
The gate verdict per band.
Where a score lands if named fixes are made.
Project score and band before committing engineering time. Pass fixes as a comma-separated list of check ids, or POST them.
path Parameters
slugProvider slug (e.g. twilio).
query Parameters
fixesComma-separated check ids to simulate.
Where a score lands if named fixes are made. › Responses
The projected score and band.
Where a score lands if named fixes are made.
The primary form, and the one the MCP simulate_fixes tool calls. Identical to the GET, which takes the same ids as a comma-separated query string for convenience; a list of check ids belongs in a body rather than in a URL once there are more than a handful of them. Projects score and band before any engineering time is committed, and re-applies the band gate to the projected state — so it will tell you when buying points still leaves you demoted. Kin Score facets are refused rather than estimated.
path Parameters
slugProvider slug (e.g. twilio).
Where a score lands if named fixes are made. › Request Body
fixesAgent-readiness dimension ids to assume fixed, e.g. ["idempotency","mcp_server"].
Where a score lands if named fixes are made. › Responses
The projected score and band.