Apiary.io was an API design and documentation tool acquired by Oracle in 2017. Learn what it offered, its current status, and the 2026 shutdown timeline.
Apiary was one of the earliest dedicated API design and documentation platforms, founded in San Francisco in 2011. Its core idea was 'API design first': teams would write a human-readable specification using Apiary's own open-source API Blueprint format, and Apiary would automatically generate interactive documentation, mock servers, and test suites from that single source of truth.
Oracle acquired Apiary in January 2017 to strengthen its API management and cloud offerings, and the product was folded into Oracle's API Platform Cloud Service and later Oracle Cloud Infrastructure. Paid plans were phased out in 2018, and Oracle has since confirmed it is retiring the service entirely, with a shutdown expected around September 2026.
Anyone evaluating apiary.io today should treat it as a legacy, end-of-life product rather than an active purchasing option. Existing users are being pointed toward migrating their specifications and documentation into other Oracle Cloud tools or third-party alternatives ahead of the shutdown date.
At its peak, Apiary offered an editor for writing API Blueprint specifications, live-updating interactive documentation generated directly from that spec, and a mock server that let front-end and back-end teams work in parallel before real endpoints existed.
It also included automated testing (dredd, an open-source tool originating from Apiary, validated real API responses against the Blueprint spec), team collaboration on shared specs, and integrations for embedding documentation into a company's own developer portal.
These capabilities were considered ahead of their time in 2013 to 2015, but the broader API tooling market has since standardized around the OpenAPI (Swagger) specification rather than Apiary's own API Blueprint format, which reduced Apiary's relative advantage over time.
Apiary no longer has an active commercial pricing structure. Paid subscription tiers were deprecated in 2018, after which the tool was accessible for free to existing users under Oracle's stewardship.
There is no current signup flow for new paid customers, and with Oracle's confirmed shutdown of the service planned for September 2026, prospective users should not budget for or plan around apiary.io as an ongoing paid product.
Teams still relying on Apiary for documentation should plan a migration budget for a replacement platform (such as SwaggerHub, Stoplight, Redocly, or Postman) rather than expecting continued free or paid access.
It is still technically online, but Oracle has announced it is being retired, with a shutdown planned around September 2026. It should be treated as end-of-life.
Oracle Corporation, which acquired Apiary in January 2017.
There is no meaningful active commercial onboarding for new customers; the product is in wind-down mode.
Migrate API specifications and documentation to another platform, such as SwaggerHub, Stoplight, Redocly, Postman, or Bump.sh, before the announced shutdown.
API Blueprint was Apiary's own open-source, Markdown-based specification language for describing REST APIs, an alternative to OpenAPI/Swagger.
Yes, historically it offered paid subscription tiers, but these were deprecated in 2018 and the tool has run as a free legacy service since.
No, but Apiary's design and documentation capabilities were integrated into Oracle's broader API management offerings after the 2017 acquisition.