API overview
The SIS API platform is organized into focused API areas. Each area has its own purpose, but they use the same authentication model and the same stable identifiers for standards.
API areas
| API | Use it for |
|---|---|
| Content | Discover standards and retrieve metadata, structure, provisions, terms, graphics, and content. |
| Projects | Retrieve project information and project changes connected to standardization work. |
| Assets | Retrieve files and binary content referenced by standards. |
| Events | Subscribe to, or retrieve, change notifications when the public event contract is available. |
| Content Preview | Explore preview features before they are launched as stable API functionality. |
Common behavior
All protected APIs require a Microsoft Entra ID access token. Send the token in the Authorization header:
Authorization: Bearer <access-token>
Responses are scoped to the access configured for the calling application. List endpoints only return resources visible to the caller. Detail endpoints can return 403 when the resource exists but the calling application does not have access to it.
Base URL
SIS provides the correct base URL for each environment during onboarding.
Examples in this documentation show paths relative to the SIS API base URL:
/api/content/v1/standards
Identifiers
Standards are addressed by URN identifiers. When a URN is used in a URL path, URL-encode it before sending the request.
See URN identifiers for the public identifier pattern.