How to Download API Schema Files for Azure Products?

Question

I am currently working with Azure API Management (APIM) to integrate various Azure services such as Speech Services, Document Intelligence, and Vision. However, I'm struggling to find the API definition files needed to import these APIs into APIM in any standard formats (OpenAPI, WADL, WSDL, OData). Although the APIs are well-documented, these files are not readily available. Is there a specific repository or website where these API schema files can be accessed?

Answer 1

Hello Mateo !

Thank you for posting on Microsoft Learn Q&A.

Microsoft publishes the official OpenAPI specs for Azure services, and you can import them straight into APIM.

You have the central repo for all Azure REST specs (management + data plane) where you browse or download from azure-rest-api-specs (OpenAPI/TypeSpec). It’s the canonical source and is indexed in the following links https://github.com/Azure/azure-rest-api-specs

and https://azure.github.io/azure-sdk/releases/latest/all/specs.html

Microsoft doc points to a Swagger/OpenAPI file you can import directly (it uses a GitHub URL) and it also explains that the Swagger covers speech-to-text with custom voice

https://learn.microsoft.com/en-us/azure/ai-services/speech-service/swagger-documentation

Azure AI document intelligence ships an official OpenAPI in the same repo. The v4.0 GA API version is 2024-11-30 (that’s the stable spec you’ll usually want).

https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/whats-new?view=doc-intel-4.0.0

There’s also a Microsoft TechCommunity thread that references the exact JSON in the repo (useful as a breadcrumb when searching)

https://techcommunity.microsoft.com/blog/azure-ai-foundry-blog/seamlessly-integrating-azure-document-intelligence-with-azure-api-management-api/4412306

For Azure AI Vision and Image Analysis you can use the specs index to find the vision and image analysis spec and pick the stable version that matches your SDK/docs, the service docs link to the REST reference that corresponds to those specs.

https://azure.github.io/azure-sdk/releases/latest/all/specs.html

https://learn.microsoft.com/en-us/azure/ai-services/computer-vision/quickstarts-sdk/image-analysis-client-library-40