API Base URL: https://api.apiproxy.sas.com/mysas
Note: The API Base URL for the APIM proxy has changed. The previous URL https://api.sas.com/mysas will continue to point to the SAS Viya Orders API Apigee proxy and require the old authentication flow until it has been fully decommissioned after April 27th, 2026.
The SAS Viya Orders API provides programmatic access to the deployment assets, certificates, and license files that are available at the My Orders tab in My SAS. You can use the API to script the downloading of the files that are needed for the SAS Viya deployment and update process.
For information about a command-line interface to this API, see SAS Viya Orders CLI.
For information about deploying SAS Viya, see SAS Viya Operations Guide.
Using the API
Get Client Credentials
Follow the instructions on the Authentication tab to obtain client credentials.
Note: Examples of credentials usage are also provided.
Select Your Cadence
See the Terminology section for formal definitions of cadence name and cadence version. To use the API endpoints that download license files and deployment assets, you need the name and possibly the version of the cadence that you want to use.
When specifying cadence name and version in your asset-download URL, use all lowercase for the cadence name and abbreviate "Long-Term Support" as "LTS".
Here are some examples:
https://api.apiproxy.sas.com/mysas/orders/{orderNumber}/cadenceNames/lts/cadenceVersions/2025.09/deploymentAssetshttps://api.apiproxy.sas.com/mysas/orders/{orderNumber}/cadenceNames/stable/2025.10/deploymentAssets
If you are patching an existing deployment, then use the cadence name and version that corresponds to what you already have deployed. When you download deployment assets at that cadence, the latest patches to it are included.
If you are unsure of what cadences are available to your order:
Click the Get Started link in your Software Order Email to go to the My Orders tab in My SAS.
Expand your order.
Click the Downloads tab to see the cadence names and versions that are available for your order (for example, "Long-Term Support - Version 2025.09").
For more information about cadences, see the FAQ in the Getting Started with SAS Viya Operations documentation.
Download Assets
For instructions and examples about download assets, see Making API Requests with an Access Token.
Terminology
cadence
the interval at which software is released and supported.
cadence name
the name associated with a release and support schedule.
cadence version
the version associated with a particular release.
certificates
a ZIP file that contains an entitlement certificate and a SAS Certificate Authority (CA). Required when using SAS Mirror Manager.
deployment assets
a TGZ file that contains Kubernetes Resources, Kustomize Overlays , and examples for deploying SAS Viya software into a Kubernetes cluster.
entitlement certificate
a certificate for authenticating to SAS distribution infrastructure to access content for a software order.
license
a file that contains licensing information for an order in the form of a JWT.
SAS Mirror Manager
a command-line utility that pulls SAS open container images from the SAS registry and pushes the images to the customer's container registry, which can be either on-premises or in the cloud.
order
a unit by which customers purchase SAS software.
order asset
a file or information needed to deploy or update SAS Viya software that can be obtained via the My Orders tab in My SAS or the SAS Viya Orders API.
a command-line interface to the SAS Viya Orders API.
Software Order Email
a message, emailed to a customer site, that announces the availability of purchased software and describes the order. The message contains download and preliminary installation steps as applicable.