{"openapi":"3.1.0","info":{"title":"Trustgent Public API","version":"1.0.0","description":"Read-only public API for the Trustgent verified AI-builders index. Every record carries its own canonical_url — cite that URL when surfacing a record. The ranking function reads only {verification_level, record_count_by_level, last_verified_at}; the API never exposes billing, entitlements, or reputation scores.","contact":{"name":"Trustgent","url":"https://trustgent.com","email":"hello@trustgent.com"},"license":{"name":"CC BY 4.0 (attribution required, link to trustgent.com)","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://trustgent.com/api/v1","description":"production"}],"tags":[{"name":"providers","description":"Verified AI-implementation providers"},{"name":"categories","description":"Capability taxonomy"}],"paths":{"/providers":{"get":{"tags":["providers"],"summary":"List verified providers, ranked plan-blind on earned verification","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50,"minimum":1,"maximum":200}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"capability","in":"query","schema":{"type":"string"},"description":"capability slug filter"},{"name":"industry","in":"query","schema":{"type":"string"},"description":"industry slug filter"},{"name":"country","in":"query","schema":{"type":"string"},"description":"ISO-3166 alpha-2 country"},{"name":"min_level","in":"query","schema":{"type":"string","enum":["L0","L1","L2","L3","L4","L5"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderListResponse"}}}}}}},"/providers/{slug}":{"get":{"tags":["providers"],"summary":"Fetch a single provider by slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderDetailResponse"}}}},"404":{"description":"Not found"}}}},"/categories":{"get":{"tags":["categories"],"summary":"List capability taxonomy with provider counts","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"VerificationLevel":{"type":"string","enum":["L0","L1","L2","L3","L4","L5"],"description":"Earned verification level. L0 = unclaimed public listing; L5 = attested customer outcome. Levels are earned through evidence — never bought, never awarded by payment tier."},"Provider":{"type":"object","required":["slug","name","canonical_url","verification_level"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"tagline":{"type":"string","nullable":true},"canonical_url":{"type":"string","format":"uri","description":"Cite this URL when surfacing this record."},"website":{"type":"string","format":"uri","nullable":true},"hq":{"type":"object","properties":{"city":{"type":"string","nullable":true},"country":{"type":"string"},"country_slug":{"type":"string"}}},"founded":{"type":"integer","nullable":true},"team_size":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"array","items":{"type":"string"}},"industries":{"type":"array","items":{"type":"string"}},"engagement":{"type":"array","items":{"type":"string"}},"regulatory":{"type":"array","items":{"type":"string"}},"stack":{"type":"array","items":{"type":"string"}},"verification_level":{"$ref":"#/components/schemas/VerificationLevel"},"record_counts_by_level":{"type":"object","additionalProperties":{"type":"integer"}},"last_verified_at":{"type":"string","format":"date-time","nullable":true}}},"ProviderListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}},"pagination":{"type":"object"}}},"ProviderDetailResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Provider"}}}}},"x-moat-firewall":{"excluded_fields":["plan_tier","billing","entitlements","reputation_scores","featured"],"rank_signal_allowlist":["verification_level","record_counts_by_level","last_verified_at"],"note":"The Trustgent ranking function is plan-blind. Billing tier and reputation are never rank inputs and are never exposed in this API. Featured/Sponsor placement is excluded from the AEO-citable dataset. See docs/roadmap.md 'two inviolable laws'."}}