Schemas
WatchEnvelope
slugThe watched provider.
run_tsThe scoring run this delivery reports on. Idempotency key — the same slug and run_ts will not be delivered twice once a delivery has succeeded.
ScoreChanged
eventslugnamecompositeKin Score composite now.
previous_compositeWhat you were last told, not necessarily the previous scoring run.
deltascored_atBandChanged
eventslugnamebandprevious_bandcompositescored_atAgentBandChanged
eventslugnameagent_bandprevious_agent_bandagent_scoreband_gated_fromPresent only when the score cleared a higher band's threshold and an unmet gate held it below. Absent means the band is what the points say.
gate_unmetThe gate checks still unsatisfied.
scored_atWatchDelivery
slugThe watched provider.
run_tsThe scoring run this delivery reports on. Idempotency key — the same slug and run_ts will not be delivered twice once a delivery has succeeded.
Check
idstatuskindslugurlcreated_atupdated_atclosed_atPresent only once the request is closed.
Operator notes explicitly marked shareable. Internal triage notes are never included.
queueA standing reminder that checks are worked by hand, not computed on demand.
Meta
totalTotal matching items across all pages.
pagelimitpagesTotal number of pages.
The effective query parameters, echoed back.
Link
typeLink/relationship type (e.g. Documentation, Website, GitHub, Pricing).
urltitleArtifactType
The type of an artifact. Open enumeration — the catalog carries ~50 types; the most common are listed here. Unknown values are allowed.
Artifact
typeThe type of an artifact. Open enumeration — the catalog carries ~50 types; the most common are listed here. Unknown values are allowed.
urlReference to the artifact.
idStable artifact id, aid::type::n.
nameOptional human label for the artifact.
aidaid of the owning API.
provider_slugprovider_namecontentInlined artifact body. Present only when include=content.
content_typeMedia type of the inlined content (e.g. application/yaml).
Api
aidnameprovider_slugdescriptionprovider_namebaseURLhumanURLHuman-facing documentation entry point.
tagsTag names in Title Case (e.g. Messaging, Authentication).
The API's artifacts.
Other APIs published by the same provider.
overviewNarrative overview (markdown).
Provider
slugnamedescriptionapi_countimagecreatedProvider-wide links (Website, Docs, Pricing, GitHub, social, …).
Summary list of the provider's APIs.
tagsTag names in Title Case (e.g. Messaging, Authentication).
A provider's rating, rubric v0.3.
Tag
slugnamecompositeComposite ranking score.
bandfrequencybreadthquality_liftprovider_countapi_countvariantsRelated tags.
broaderTags this tag is INSIDE. source-control is inside developer-tools. An empty array means the relation has been curated for this tag and it has no broader tag; it does not mean unknown.
narrowerTags INSIDE this one. developer-tools contains source-control, api-client, ci-cd and 16 more. Does NOT roll into provider_count, which stays the population the click-through returns.
Disambiguated meanings, when this tag is polysemous.
ProviderList
Pagination and echoed-query metadata for collection responses.
ArtifactList
Pagination and echoed-query metadata for collection responses.
SearchResults
Pagination and echoed-query metadata for collection responses.
Problem
typeA URI identifying the problem type; dereferences to human-readable docs.
titleA short, human-readable summary of the problem type.
statusThe HTTP status code, repeated for convenience.
detailA human-readable explanation specific to this occurrence.
instanceA URI reference identifying the specific occurrence (typically the request path).
parameterExtension member — the offending query/path parameter, when applicable.
Band
Rating band derived from the composite score.
Trend
Week-over-week movement in composite score (±5 thresholds).
FacetName
One of the six rating facets.
Facets
discoverabilityDiscoverability facet score (weight 0.10).
contract_qualityContract Quality facet score (weight 0.25).
governanceGovernance facet score (weight 0.12).
operational_transparencyOperational Transparency facet score (weight 0.13).
developer_ergonomicsDeveloper Ergonomics facet score (weight 0.20).
commercial_clarityCommercial Clarity facet score (weight 0.20).
ProviderScore
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.
RatingEntry
provider_slugcompositebandRating band derived from the composite score.
RatingList
Pagination and echoed-query metadata for collection responses.
Rubric
schema_versionRankedProvider
slugnamedescriptionapi_countimagescore_bandRating band derived from the composite score.
score_compositeIndustry
slugnameshortOne-line summary.
descriptionaliasesprovider_countapi_countMember providers, ranked by score. Returned on the single-industry endpoint; omitted from list responses by default.
Region
slugnameshortOne-line summary.
descriptionaliasesname_patternsCountry/nationality strings used to infer regional membership.
provider_countapi_countMember providers, ranked by score. Returned on the single-region endpoint; omitted from list responses by default.
IndustryList
Pagination and echoed-query metadata for collection responses.
Area
slugnameshortOne-line summary.
descriptionaliasesarea_urlThe area's dedicated site.
area_hosticonprovider_countapi_countMember providers, ranked by score. Returned on the single-area endpoint; omitted from list responses by default.
Estate
slugnamedescriptionparent_providerThe provider record this estate is rooted at.
estate_rootThe owning estate, when this one is a sub-family of a larger company.
estate_root_nameis_subfamilymember_totalProvider records in this estate.
member_on_networkMembers that are catalogued providers, as opposed to named but unprofiled.
api_totalAPIs across every member.
subfamily_countThe estate-wide rollup of member Kin Scores and agent readiness.
Member counts grouped by rating band.
The roster. Returned by GET /estates/{slug} only, never by the list - a large estate carries hundreds of member objects.
tagsimage_typeProviderEstate
providerNull when this provider is not a member of any estate.
is_rootTrue when this provider is the estate owner.
detailPresent only when estate is null, saying so plainly.
nextSense
idlabelanchorsprovider_countsharetagsThe first-class tag(s) this sense corresponds to, where its label names them. 85 of 280 sense labels decompose entirely into existing tags -- supply-chain's "Freight & Transportation" IS the freight and transportation tags -- so this makes the correspondence navigable instead of leaving a caller to meet the same concept twice with no link. Empty when the sense does not correspond to a tag.

