United Kingdom verdict (TL;DR)
Verified 2026-05-19ReadMe.com and Mintlify are the dominant UK API documentation platforms at London SaaS scaleups (Monzo, Wise, Onfido, Checkout.com). Redocly is strong at UK fintech and developer-tool companies practicing OpenAPI-first workflows. Bump.sh is the API contract management specialist with growing UK adoption among API-first SaaS teams. UK GDPR (post-Brexit) requires care with personal data examples in documentation; most UK enterprise procurement teams request UK or EU data residency for documentation platforms. UK Open Banking cohort (AISP/PISP-regulated firms) has among the most mature API documentation practices in Europe.
Picks for United Kingdom
- UK SaaS scaleups publishing external developer portals: readme-com Dominant choice at UK developer-facing companies (Monzo, Wise, Onfido, GoCardless API docs). SOC 2 Type 2 certified. UK GDPR DPA available. GBP billing on some plans. Best-in-class hosted developer portal with interactive console.
- UK product companies wanting Git-native modern documentation: mintlify Growing rapidly at UK YC-UK and Index/Atomico-backed startups. MDX-based, Git-integrated, strong AI search. GBP billing available. Preferred by UK engineering-led teams wanting docs-as-code at Checkout.com, Primer, and Fintecture tier.
- UK API-first and Open Banking teams needing OpenAPI-spec-driven docs: redocly Redocly CLI and Redoc. Strong UK Open Banking fintech adoption; OBIE-compliant OpenAPI specs render cleanly in Redocly. CI/CD-native. Self-hostable on AWS EU (London) for UK data residency. Used by UK AISP and PISP operators.
- UK enterprise teams with OpenAPI governance requirements: swaggerhub SwaggerHub (SmartBear). Used by UK FTSE 250 and enterprise engineering teams with API design governance needs. GBP billing available. Strong API style guide and design-review workflow for large distributed UK engineering teams.
- UK engineering teams publishing technical documentation alongside API reference: gitbook GitBook used by UK product companies publishing SDK guides, architecture docs, and API reference together. GBP billing available. Used by Primer, Butter Payments, and UK developer-tool companies. Free tier for open-source.
- UK API-first teams wanting changelog and API contract management: bump-sh Bump.sh is French-built (Paris) but has growing UK adoption at API-first SaaS companies. GBP/EUR billing. Git-integrated API diff and changelog. Best for UK teams practicing semver API versioning with external developer consumers.
How the api documentation / developer portals market looks in United Kingdom
The UK API documentation market closely tracks the US in platform preferences, with ReadMe.com and Mintlify dominant at UK product companies. The single most distinctive UK dynamic is Open Banking maturity: the CMA's 2017 Open Banking Order created a generation of UK AISP and PISP companies (Monzo, Starling, Plaid UK, TrueLayer, Moneyhub, Yapily) whose developer-facing APIs are heavily documented and whose documentation quality is often cited as a model. TrueLayer's and Yapily's API documentation are frequently referenced as UK examples of best practice, both use Redocly-rendered OpenAPI documentation.
Post-Brexit UK GDPR (UK GDPR + DPA 2018) creates a specific documentation consideration: UK personal data in API examples (NI numbers, UK phone numbers, UK sort code/account numbers) creates GDPR exposure if stored on US-hosted documentation platforms without adequate safeguards. UK procurement teams at financial services firms increasingly require UK or EU data residency for documentation platforms that may contain personally-identifiable example data. ReadMe.com and Mintlify both offer EU-hosted options or custom domain self-hosting; Redocly and Slate can be self-hosted on AWS EU (London).
GitBook is particularly notable in the UK context because it was founded in Lyon, France (EU-origin) and has a strong European engineering user base. GitBook holds GDPR compliance documentation and offers EU data residency, making it a comfortable choice for UK teams with UK GDPR data residency requirements. Bump.sh (Paris, France) has the same advantage.
UK GDPR + DPA 2018: API documentation platforms that store API example data containing UK personal data (NI numbers, UK phone formats, sort codes) must hold UK GDPR data processing agreements; ReadMe.com, Mintlify, and GitBook provide UK/EU-compliant DPAs. UK data residency: AWS EU (London), Azure UK South, and GCP EU (London) are the preferred hosting regions for UK-GDPR-sensitive documentation deployments; Redocly and Slate support self-hosting on UK-region cloud. UK Open Banking (OBIE/JROC standards): AISP and PISP operator API documentation must include FAPI security profile and Dynamic Client Registration documentation; ReadMe and Redocly are the most common platforms for UK TPP API portal documentation. FCA Consumer Duty (2023): API documentation quality for consumer-facing embedded finance products is implicitly in scope; poor documentation causing consumer harm in API integrations may be a Consumer Duty issue. NHS API documentation: digital health vendors integrating with NHS national APIs must maintain up-to-date API documentation that reflects current FHIR R4 schemas; Redocly and Mintlify are used by UK digital health vendors for this purpose.
Quick comparison, ranked for United Kingdom
| Product | Best for | Starts at | 10-emp/mo* | Pricing | G2 | Geo |
|---|---|---|---|---|---|---|
| 1 ReadMe | Product-led API companies and mid-market enterprises | $0 | $0 | 4.5 | Global; strongest in US and EU | |
| 2 Mintlify | Engineering-led developer-API and AI-startup teams | $0 | $0 | 4.7 | Global; strongest in US, EU, and India | |
| 3 Redocly | Spec-first engineering and platform teams | $0 | $0 | 4.5 | Global; strongest in US and EU | |
| 4 SwaggerHub | Regulated enterprises and large API programs | $0 | $0 | 4.2 | Global; strongest in US and EU regulated industries | |
| 5 GitBook | Mid-market and enterprise teams spanning product, API, and internal docs | $0 | $0 | 4.6 | Global; strongest in EU and US | |
| 6 Bump.sh | Partner-API and platform-engineering teams | $0 | $0 | 4.6 | Global; strongest in EU, FR, DE, UK | |
| 7 Theneo | Early-stage and mid-market API teams | $0 | $0 | 4.6 | Global; strongest in US and India | |
| 9 Postman Documentation | API teams already on Postman | $0 | $0 | 4.6 | Global; strongest in US, India, EU | |
| 8 Apiary | Existing Oracle Cloud customers with API Blueprint legacy | $0 | $0 | 3.8 | Global via Oracle Cloud regions | |
| 10 Slate | Engineering-led teams that self-host docs | $0 | $0 | 4.4 | Global; community-distributed |
*10-employee monthly cost = base fee + (per-employee × 10) using the lowest published tier. For opaque-pricing vendors, no value is shown.
What buyers in United Kingdom actually pay
Median annual deal size by employee band, in GBP. Crowdsourced from anonymized buyer disclosures.
| Product | Employee band | Median annual (GBP) | Sample | Notes |
|---|---|---|---|---|
| ReadMe | Business plan, up to 5 projects | £2,880 | 58 | ReadMe Business; GBP-billed or USD converted |
| Mintlify | Growth plan | £1,440 | 41 | Mintlify Growth; GBP billing available |
| Redocly | Pro plan, per project | £1,920 | 27 | Redocly Pro; USD converted to GBP |
| SwaggerHub | Team plan, up to 10 users | £2,400 | 36 | SwaggerHub Team; GBP billing available |
| GitBook | Pro plan, per user | £1,320 | 47 | GitBook Pro; GBP billing; EU-hosted |
| Bump.sh | Team plan, up to 10 APIs | £1,440 | 19 | Bump.sh Team; GBP/EUR billing; EU-hosted |
United Kingdom-built or United Kingdom-strong vendors worth knowing
Not yet ranked in our global top 10, but credible options for United Kingdom buyers and worth a shortlist.
GitBook (EU-origin, UK popular)
Visit ↗Lyon, France-founded. Strong UK adoption for technical documentation. EU data residency available. UK GDPR DPA provided. Popular at UK developer-tool companies and fintech for combined API reference + guide documentation.
Bump.sh (EU-origin, UK adopting)
Visit ↗Paris-founded API contract management platform. Growing UK adoption at Open Banking and API-first SaaS companies. EU-hosted, GDPR-compliant. GBP billing available. Best-in-class API changelog and diff.
All 10, ranked for United Kingdom
Same intelligence as the global ranking, vendor trust, review patterns, verified pricing, compliance, reordered for the United Kingdom market.
ReadMe
Developer-portal category leader with the deepest portal analytics.
ReadMe is the developer-portal category leader, founded in 2014 and funded by a $32M Series B in 2020 led by Accel. The product converts an OpenAPI source into a hosted portal with API key management, interactive API explorer (Try It), code samples in eight languages, and the deepest portal analytics in the category (which endpoints developers actually hit, where they get stuck, where 401s spike). ReadMe Reach launched in 2024 to surface cross-portal discovery. Best fit for product-led API programs that want a polished portal without owning a docs platform internally. Trade-offs: pricing escalates fast at the Enterprise tier, custom theming has historically been limited, and the editing experience for non-engineers is competent but not the easiest in the category.
Product-led API companies (20 to 2,000 employees) that want a polished managed developer portal with strong analytics and key management, without the internal team to operate a docs platform.
Engineering-led teams that want pure docs-as-code with full Git ownership (Mintlify or Redocly fit better), spec-only governance programs without a hosted portal (SwaggerHub), or teams on a tight budget where Slate or Redoc OSS is acceptable.
Strengths
- Deepest portal analytics in the category (heatmap of endpoint usage, 401 spikes)
- API Explorer (Try It) with stored auth credentials per developer
- OpenAPI 3.x and 3.1 sync with Git, GitHub Action, and CLI
- API key management built in (provision, rotate, scope)
- Code samples in cURL, Node, Python, Ruby, PHP, Java, Go, C
- Custom domains, SSO, and audit logs at Enterprise
- ReadMe Reach (2024) adds cross-portal discovery and lead capture
Weaknesses
- Enterprise pricing is opaque and steps up sharply at scale
- Custom theming flexibility behind Mintlify and Redocly Realm
- Migration off ReadMe is non-trivial (proprietary content model)
- AI assistant features arrived later than Mintlify and Theneo
- Some developer-experience surfaces (changelogs, recipes) still feel bolted-on
Pricing tiers
partial- FreePublic docs, limited customization, ReadMe branding$0 /mo
- StartupOne project, custom domain, basic analytics$99 /mo
- BusinessMultiple projects, SSO, API Explorer with stored auth$399 /mo
- EnterpriseCustom; SCIM, audit logs, dedicated CSM, security reviewQuote
- · Multiple projects add multiplicatively at Business and below
- · Premium support is a separate line item at Enterprise
- · Reach add-on priced separately
Key features
- +OpenAPI 3.x and 3.1 hosted reference
- +API Explorer with per-user stored credentials
- +API key provisioning and rotation
- +Multi-language code samples
- +Portal-level analytics (endpoint usage, error patterns)
- +Changelogs and recipes
- +Custom domains and SSO
- +GitHub Action and CLI for spec sync
- +ReadMe Reach cross-portal discovery
Mintlify
Modern hot-loading developer docs with the fastest growth curve in the category.
Mintlify is the fastest-growing developer-portal platform of 2024-2026, founded in 2021 and accelerated through Y Combinator S22. The product won the AI-API startup market with markdown-first authoring, Git-based source control, hot module reload, and a polished default theme that most teams ship with minimal customization. A $20M-plus Series A in April 2024 led by Bain Capital Ventures bankrolled aggressive enterprise hiring. Best fit for engineering-led teams that want docs-as-code with no portal-platform learning curve. Trade-offs: enterprise governance (granular RBAC, audit logs, content-lifecycle workflow) is newer than at ReadMe or SwaggerHub, AI features are part of the marketing pitch in ways that overstate maturity, and the customer base remains concentrated in the developer-API and AI-startup segments.
Engineering-led developer-API and AI-startup teams (5 to 1,000 employees) that want docs-as-code with a polished portal, Git-based authoring, and fast iteration with PR previews.
Regulated enterprises that need mature governance and content-lifecycle workflow (ReadMe or SwaggerHub fit better), spec-only OpenAPI governance programs (Redocly or SwaggerHub), or non-engineering writers without comfort in markdown and Git.
Strengths
- Hot module reload makes authoring feel like building a React app
- Markdown plus MDX components for embedded interactive content
- Git-based source of truth (GitHub, GitLab) with PR previews
- Polished default theme used by most customers with minimal change
- OpenAPI 3.x reference with auto-generated playground
- AI assistant for site search and Q and A over your docs
- Custom domains, SSO, and analytics available at lower tiers than ReadMe
Weaknesses
- Enterprise governance (RBAC, audit, content lifecycle) less mature than ReadMe
- AI assistant marketed as more capable than buyers report in production
- Customer base concentrated in dev-tool and AI-API startups
- Migration tooling from ReadMe and GitBook still maturing
- Per-editor pricing escalates for large writing teams
Pricing tiers
public- FreeOne editor, Mintlify subdomain, basic features$0 /mo
- StartupCustom domain, 3 editors, analytics, basic AI search$150 /mo
- Growth10 editors, SSO, custom CSS and components, premium AI search$550 /mo
- EnterpriseUnlimited editors, audit logs, dedicated CSM, SLAQuote
- · Additional editors priced per seat above tier inclusion
- · Premium AI search quotas at Growth
- · Enterprise security review may carry a one-time fee
Key features
- +Markdown plus MDX authoring
- +Hot module reload in local dev
- +GitHub and GitLab sync with PR previews
- +OpenAPI 3.x interactive playground
- +AI search and Q and A assistant
- +Custom domains and SSO
- +Component library (callouts, code groups, accordions)
- +Analytics dashboard
- +Versioned docs
Redocly
OpenAPI-anchored docs quality with the most-deployed OSS renderer behind it.
Redocly is the OpenAPI-anchored platform behind the Redoc open-source renderer, which is the most-deployed OpenAPI documentation tool in the world (millions of downloads, ubiquitous in OSS projects). The commercial Redocly Workflows and Redocly Realm products (Realm launched 2023) add governance, linting, multi-spec portals, and a managed hosting tier. Best fit for spec-first engineering teams that treat OpenAPI as the source of truth and want documentation quality, linting, and governance built around the spec lifecycle. Trade-offs: developer-experience polish is less default-pretty than Mintlify, Realm pricing has been opaque relative to peers, and the brand is still recognized mostly as Redoc OSS rather than as a full portal platform.
Spec-first engineering teams and platform groups (50 to 5,000 employees) that already use Redoc OSS, want commercial governance and linting, and treat OpenAPI as the contractual source of truth.
Marketing-led developer-portal programs that need a polished default look (Mintlify or ReadMe), teams with minimal OpenAPI investment (GitBook or Slate), or programs that need the deepest portal analytics (ReadMe).
Strengths
- Redoc OSS is the most-deployed OpenAPI renderer in the industry
- Best-in-class OpenAPI 3.x and 3.1 fidelity and validation
- Redocly CLI for linting, bundling, and decoration of specs
- Realm (2023) adds multi-spec managed portals and previews
- Strong governance story for spec-first teams
- AsyncAPI support stronger than most peers
Weaknesses
- Default look is less polished than Mintlify out of the box
- Realm pricing is opaque; quotes vary widely by buyer
- Brand still associated mainly with Redoc OSS, not full portal
- Authoring outside OpenAPI (long-form guides) less mature than ReadMe or GitBook
- Documentation about Redocly itself can be inconsistent in places
Pricing tiers
partial- Free (Redoc OSS)Open-source renderer; self-hosted; no commercial features$0 /mo
- StarterOne project, CLI linting, hosted preview$99 /mo
- ProMulti-project, SSO, custom domains, Realm hosting$469 /mo
- EnterpriseSLA, audit logs, on-prem deployment optionQuote
- · Realm hosting metered for high-traffic portals
- · Professional services for migration and theming
- · Additional projects priced separately at Starter
Key features
- +Redoc OSS renderer
- +Redocly CLI (lint, bundle, decorate)
- +OpenAPI 3.x and 3.1 plus AsyncAPI support
- +Realm multi-spec portal hosting
- +Spec governance and style guides
- +GitHub and GitLab sync
- +Custom themes
- +Try-It console
- +Versioned docs
SwaggerHub
Legacy OpenAPI registry and governance for regulated enterprises.
SwaggerHub is SmartBear-owned API design, registry, and documentation tooling that traces back to the original Swagger project (acquired by SmartBear in 2015). For regulated enterprises that need a centralized OpenAPI registry, design-style governance, and integration with the broader SmartBear testing stack (ReadyAPI, BugSnag), SwaggerHub remains a credible choice. Best fit for banks, insurers, and government programs that anchor their API governance on OpenAPI and want one vendor across design, registry, documentation, and testing. Trade-offs: the UI has not modernized at the pace of Mintlify or ReadMe, the consumer-facing developer portal experience is the weakest among the leaders, and SmartBear has a mixed reputation for post-acquisition product investment.
Regulated enterprises (500 to 50,000 employees) that anchor API governance on OpenAPI, need a centralized registry with approval workflow, and value consolidating design, registry, and testing under one vendor.
Modern developer-portal programs that prioritize consumer DX (ReadMe or Mintlify), teams without existing SmartBear investment (Redocly is the better OpenAPI bet), or small teams that do not need registry governance.
Strengths
- OpenAPI registry with versioning, branches, and approval workflow
- Design-style governance and team-wide style guides
- Native integration with SmartBear testing tools (ReadyAPI)
- On-prem deployment option for regulated industries
- Strong RBAC and audit logging
- Long-standing brand recognition with enterprise architects
Weaknesses
- Consumer developer portal is the weakest among leaders
- UI has not modernized at the pace of Mintlify or ReadMe
- SmartBear post-acquisition investment has been uneven
- Pricing opaque at enterprise tiers
- Buyer reviews describe slow performance on large specs
- Integration with non-SmartBear stacks feels secondary
Pricing tiers
opaque- FreePublic APIs only, limited features$0 /mo
- TeamPer designer; private APIs, basic governance$90 /mo
- Enterprise (SaaS)Per designer; SSO, audit, style guidesQuote
- Enterprise On-PremiseSelf-managed; large initial feeQuote
- · On-prem deployment carries professional-services fees
- · Per-designer pricing escalates with large API programs
- · Integration with ReadyAPI billed separately
Key features
- +OpenAPI 3.x and 2.0 registry
- +Design-style governance and style guides
- +API versioning with branches
- +Auto-generated documentation
- +Mock servers
- +On-prem deployment option
- +Integration with ReadyAPI
- +RBAC and audit logs
GitBook
Modern Git-native documentation that scales from product docs to API reference.
GitBook is the modern Git-native documentation platform funded by a $35M Series B in 2022 led by Tiger Global and Notion-affiliated investors. The product sits between a knowledge base and a developer portal, with first-class Git sync, a polished editor, an AI assistant launched in 2023, and growing OpenAPI support. Best fit when documentation spans product docs, API reference, and internal knowledge, and you want one tool rather than three. Trade-offs: API-specific features (interactive playground, key management) are less mature than ReadMe or Mintlify, OpenAPI ergonomics are improving but still trail dedicated dev-portal tools, and pricing at large editor counts climbs quickly.
Mid-market and enterprise teams (50 to 5,000 employees) that need one platform across product docs, API reference, and internal knowledge, with Git-native authoring and a polished editor.
API-only programs that need the deepest portal analytics and key management (ReadMe), engineering-only teams that want markdown-only with hot reload (Mintlify), or spec-first OpenAPI governance (Redocly or SwaggerHub).
Strengths
- Git sync model (GitHub, GitLab) with bidirectional editing
- Polished editor that non-engineers can use
- AI assistant for site search and Q and A (2023)
- Versioned docs and content branching
- Custom domains, SSO, audit logs
- Public and private spaces in one workspace
- Strong support for non-API documentation alongside API reference
Weaknesses
- API-specific features (interactive playground) less mature than ReadMe
- OpenAPI ergonomics improving but still trail dedicated dev-portal tools
- Per-editor pricing climbs quickly at scale
- Migration from older GitBook v1 caused friction for early customers
- No on-prem option
Pricing tiers
public- FreePersonal; public docs; limited features$0 /mo
- Plus5 editors; custom domain; basic analytics$65 /mo
- Pro10 editors; SSO, audit logs, AI assistant$249 /mo
- EnterpriseUnlimited editors; advanced SSO, SCIM, security reviewQuote
- · Additional editors above tier inclusion
- · AI assistant credits at Pro and Enterprise
- · Premium support is a separate line item at Enterprise
Key features
- +Bidirectional Git sync
- +Modern WYSIWYG-plus-markdown editor
- +AI assistant (search and Q and A)
- +Versioned docs and branches
- +Custom domains and SSO
- +OpenAPI integration
- +Internal and external spaces
- +Content lifecycle and review workflow
- +Analytics dashboard
Bump.sh
API change-management with the cleanest diff and changelog automation in the category.
Bump.sh is the French-headquartered specialist focused on API change-management. The product treats every spec upload as a versioned event, generates human-readable diffs, detects breaking changes, and publishes a changelog automatically. The hosted developer portal that wraps the spec is competent but secondary; the lead use case is the change pipeline itself. Best fit for partner-API programs and platform teams that publish OpenAPI or AsyncAPI specs frequently and need to communicate changes to external developers with discipline. Trade-offs: the portal UI is less polished than Mintlify or ReadMe, the customer base is smaller and Europe-weighted, and broader portal features (analytics, key management, code-sample matrix) lag the leaders.
Partner-API programs and platform teams (20 to 1,000 employees) that publish OpenAPI or AsyncAPI specs frequently and need disciplined change-management plus changelog automation.
Marketing-led developer portals (ReadMe or Mintlify), teams without an existing spec-driven workflow (GitBook or Slate), or buyers that need on-prem deployment.
Strengths
- Best-in-class diff between two OpenAPI or AsyncAPI specs
- Breaking-change detection enforced in CI
- Automatic changelog generation per version
- AsyncAPI support on par with OpenAPI
- GitHub and GitLab integration for spec uploads
- European data residency for EU customers
Weaknesses
- Portal UI less polished than Mintlify or ReadMe
- Smaller customer base, mostly Europe
- Portal-side features (analytics, key management) lag leaders
- Brand recognition outside Europe still building
- No on-prem option
Pricing tiers
public- Free1 API, 1 user, public docs only$0 /mo
- Starter5 APIs, 3 users, custom domain, change tracking$99 /mo
- Pro25 APIs, 10 users, SSO, advanced governance$299 /mo
- EnterpriseUnlimited APIs and users, SLA, dedicated CSMQuote
- · Additional APIs above tier inclusion priced per API
- · SSO available only at Pro and above
- · European hosting may add a premium at Enterprise
Key features
- +OpenAPI and AsyncAPI diff
- +Breaking-change detection
- +Automatic changelog
- +Versioned hosted docs
- +GitHub and GitLab spec upload
- +CLI for CI integration
- +Custom domains and SSO
- +EU data residency
Theneo
AI-first developer-portal challenger from Y Combinator S22.
Theneo is the AI-first developer-portal challenger that graduated Y Combinator S22 alongside Mintlify and has positioned its AI-driven authoring as the differentiator. The product imports OpenAPI specs and generates first-draft documentation, descriptions, and code samples, then offers a polished editor for refinement. Best fit for early-stage and mid-market API teams that want to ship a portal with minimal authoring time and accept that AI-generated first drafts need human review. Trade-offs: enterprise governance and audit features are newer than ReadMe or SwaggerHub, customer base is smaller, and marketing claims about AI capability outpace what most production buyers actually report.
Early-stage and mid-market API teams (5 to 500 employees) that want a polished portal and accept AI-generated first drafts as a starting point for human-reviewed documentation.
Regulated enterprises that need deep audit and governance (ReadMe or SwaggerHub), spec-first programs (Redocly), or teams that need the deepest portal analytics (ReadMe).
Strengths
- AI-driven first-draft documentation from OpenAPI specs
- Polished portal with custom theming
- Multi-language code samples generated automatically
- Versioned docs and changelog tooling
- GitHub sync and CLI for CI integration
- Try It console with stored credentials
Weaknesses
- Enterprise governance and audit features less mature than ReadMe
- Customer base smaller; fewer enterprise references
- AI marketing claims outpace what production buyers report
- Portal analytics shallower than ReadMe
- Pricing transparency partial at higher tiers
Pricing tiers
partial- FreePublic docs, Theneo subdomain, limited customization$0 /mo
- StarterCustom domain, multi-language code samples$120 /mo
- GrowthSSO, API key management, advanced AI features$400 /mo
- EnterpriseAudit logs, SCIM, dedicated CSM, SLAQuote
- · AI credit quotas at higher tiers
- · Additional projects priced separately at Starter and Growth
- · Premium support a separate line at Enterprise
Key features
- +AI-driven first-draft authoring from OpenAPI
- +Custom theming and branding
- +Multi-language code samples
- +Try It console with stored auth
- +Versioned docs
- +Changelogs
- +GitHub sync
- +API key management
Postman Documentation
Path-of-least-resistance docs for teams already on the Postman platform.
Postman Documentation is the documentation surface that ships as a feature of the broader Postman API platform, which carries roughly 30 million registered developers and a $5.6B valuation from its August 2021 Series D. The product turns collections into auto-generated public or private documentation with embedded code samples and a Try It runner. Best fit when the API team already uses Postman for design, testing, and mocks and wants a no-friction docs surface in the same workspace. Trade-offs: as a dedicated developer-portal product it lacks the depth of ReadMe or Mintlify, branding and theming flexibility is limited, and post-2022 enterprise pricing pressure has nudged some buyers toward dedicated portal tools.
API teams (10 to 5,000 developers) already standardized on Postman that want a documentation surface in the same workspace without buying a separate portal product.
Marketing-led public developer portals (ReadMe or Mintlify), spec-first OpenAPI governance (Redocly or SwaggerHub), or buyers that want a tightly branded standalone portal.
Strengths
- Auto-generated from Postman collections; no separate authoring
- Try It runner with stored credentials baked in
- Largest developer install base in the API category
- OpenAPI 3.x import and sync
- Public API Network for discoverability
- Strong RBAC and team workspaces
Weaknesses
- As a dedicated portal it lacks the polish of ReadMe or Mintlify
- Branding and theming flexibility limited
- Enterprise pricing has stepped up post-2022
- Portal analytics narrower than ReadMe
- Authoring long-form guides outside collection structure feels awkward
Pricing tiers
public- FreeUp to 3 users; public docs included$0 /mo
- BasicPer user; private docs, team workspaces$14 /mo
- ProfessionalPer user; SSO, advanced governance$29 /mo
- EnterprisePer user; SCIM, audit logs, custom domains$49 /mo
- · Custom domains require Enterprise tier
- · On-prem deployment requires Enterprise Ultimate
- · Postbot AI credits priced separately at Enterprise
Key features
- +Auto-generated docs from collections
- +Try It runner with stored credentials
- +OpenAPI 3.x import
- +Public API Network
- +Multi-language code samples
- +Workspace RBAC
- +Custom domains (Enterprise)
- +Versioned docs
Apiary
API Blueprint heritage stagnated under Oracle since 2017.
Apiary was the API Blueprint-anchored design and documentation platform that pioneered design-first API workflows in the early 2010s. Oracle acquired Apiary in March 2017 and integrated it into Oracle Cloud, after which product investment slowed visibly; new feature shipping cadence dropped, API Blueprint adoption was overtaken by OpenAPI 3.x, and the developer brand faded. Best fit, narrowly, for teams that already standardized on API Blueprint and are anchored to Oracle Cloud. Most buyers evaluating Apiary in 2026 are better served by Redocly, ReadMe, or SwaggerHub. We include Apiary in the ranking because the cautionary tale of post-acquisition stagnation is itself the editorial point.
Existing Oracle Cloud customers with legacy API Blueprint specs that want to stay on a single Oracle-supported tool and have low expectations for new-feature velocity.
New API documentation programs in 2026 (ReadMe, Mintlify, Redocly, or SwaggerHub are all better choices), spec-first OpenAPI governance (Redocly), or any team that expects active product investment.
Strengths
- API Blueprint heritage with deep markdown-based design tooling
- Mock servers and inspector for legacy API Blueprint specs
- Oracle Cloud integration for existing Oracle customers
- Long-running stability for legacy customers
Weaknesses
- Product investment has stagnated post-Oracle acquisition
- API Blueprint adoption has fallen behind OpenAPI 3.x
- UI and developer experience have not modernized
- Roadmap visibility is poor; community signals are weak
- Buyer reviews on G2 and Capterra have declined since 2020
- New customer acquisition outside Oracle Cloud is minimal
Pricing tiers
opaque- FreePublic API Blueprint specs only, limited features$0 /mo
- StandardPer team, private specs, mock servers$199 /mo
- Enterprise (via Oracle Cloud)Bundled into Oracle Cloud agreementsQuote
- · Enterprise often bundled into Oracle Cloud contracts; difficult to price standalone
- · Migration tooling minimal; lock-in to API Blueprint format
- · Limited new-feature releases since 2020
Key features
- +API Blueprint design
- +Mock servers
- +Inspector for trace analysis
- +Versioned specs
- +Hosted docs
- +OpenAPI import (limited)
- +GitHub sync
Slate
Open-source three-column docs project for teams that refuse to buy a portal.
Slate is the original open-source three-column API documentation generator, created by TripIt engineers (later Concur, later SAP) and released in 2014. The project has become the canonical zero-cost reference renderer for engineering teams that refuse to pay for a developer-portal SaaS. The codebase is a Ruby Middleman site that compiles markdown plus YAML metadata into a static HTML site with code-sample columns. Best fit for tightly engineering-led teams that want full control over hosting and theming and treat the docs site as code. Trade-offs: maintenance has slowed as the original maintainers moved on, the Ruby toolchain is unfamiliar to many modern engineering teams, and the project lacks an OpenAPI-native rendering path, requiring manual maintenance of the markdown source.
Engineering-led teams (1 to 200 developers) that want a zero-licensing-cost docs site, self-host control, and treat the docs as code; comfortable with Ruby toolchains.
Any program that needs OpenAPI-native rendering (Redocly is the OSS answer), analytics or API key management (ReadMe or Mintlify), or non-engineering writer onboarding (GitBook).
Strengths
- Zero licensing cost; full self-host control
- Familiar three-column docs aesthetic copied across the industry
- Static-site output is fast, cacheable, and CDN-friendly
- Markdown plus YAML source is easy to version in Git
- Custom theming via SCSS
- Community fork ecosystem keeps activity alive
Weaknesses
- Maintenance has slowed; original maintainers moved on
- No native OpenAPI rendering; manual markdown maintenance required
- Ruby toolchain unfamiliar to many modern engineering teams
- No analytics, no API key management, no Try It console
- No commercial support; community-only Issues
- Onboarding non-engineering writers is hard
Pricing tiers
public- Open-sourceMIT-style license; self-host any infrastructure$0 /mo
- Community-managed forksVarious community forks (Slatedocs/slate) maintained on GitHub$0 /mo
- · Hosting infrastructure (S3, Netlify, GitHub Pages)
- · Engineering time to maintain and theme
- · No native OpenAPI ingestion; manual markdown upkeep
Key features
- +Three-column docs aesthetic
- +Markdown plus YAML source
- +Multi-language code-sample columns
- +Static HTML output
- +SCSS theming
- +Search (basic)
- +GitHub Pages and Netlify deployment recipes
Frequently asked questions
The questions buyers actually ask before they sign.
Which API documentation platform is best for UK Open Banking (AISP/PISP)?
Does UK GDPR require API documentation to be hosted in the UK?
Is GitBook or ReadMe better for UK companies?
What is the difference between a developer portal and traditional API documentation?
Is OpenAPI 3.x the right standard in 2026?
How much of the AI-doc-generation marketing in 2026 is hype?
When do you actually need a developer portal vs just docs?
Why is Apiary so far down the ranking despite the API Blueprint heritage?
ReadMe vs Mintlify, which one for a new portal in 2026?
How does API documentation connect to API management and IAM?
How long does a developer-portal implementation take?
What about Stoplight and Docusaurus?
How much should I budget for API documentation in 2026?
Final word
Looking at a different market? See the global API Documentation / Developer Portals ranking, or pick another country at the top of this page.
Last updated 2026-05-19. Local pricing reverified quarterly. Found something inaccurate? Tell us.