altered-tech/unifi-openapi-specs

unifi-openapi-specs is a community project that collects and organizes API documentation for Ubiquiti's UniFi products, covering the Site Manager, Network, Protect, and Mobility services. UniFi does not officially publish these specifications in a ready to use, machine readable format on its own, so this project fetches them directly from Ubiquiti's developer website and repackages them as OpenAPI specification files and Postman collections, two common formats that developer tools already understand. Every version of each service's API that Ubiquiti has published is kept here, going back several releases for Network and Protect, so a developer working against an older console firmware version can still find the matching specification instead of only the latest one. Each specification lists both ways a UniFi console can be reached, either directly over the local network or through Ubiquiti's cloud connector service. The project provides direct download links to every spec file, which plug straight into tools like Swagger UI, Postman, Insomnia, or code generators that can automatically build a client library from an OpenAPI file. There is also a small browsable documentation site for looking through the specifications without any extra tooling. Behind the scenes, a script written in Python fetches the raw specification files from Ubiquiti's site, cleans up naming so the files follow the OpenAPI standard correctly, and adjusts certain schema definitions so stricter code generation tools can handle them without errors. A scheduled GitHub Action runs this script automatically once a day, so newly released API versions get added without anyone doing it by hand. The project can also be run locally with Python 3.11 or newer to fetch, discover, or validate specs yourself. It is released under the MIT license and is not affiliated with or endorsed by Ubiquiti.