| Module | Path | Switches | Description / Use |
|---|---|---|---|
| Switch/Attribute Globals | ?release=[release] | Define the release-file to load. Most modules support defining this attribute, if not the default (latest publication) will be used. Example: ?release=201504 | |
| Releases | /releases/ | ?drafts=[bool] | Get a list of the avaliable publications from JISM-XML files. |
| /releases/detail | ?release=[release] | Using release switch, get Publication details from one release. | |
| Control | /control/ | - | Get all controls for a release |
| /control/list/ | ?number=[number] | Using the control number, get a single control Example: ?release=201709&number=0123 | |
| /control/words/ | - | Get a frequency-ordered list of all words used in all controls within this release | |
| /control/stats/ | Never implemented | ||
| control/classifications/ | ?number=[number] | Using the control number, get the classification markings applicable to a single control Example: ?release=201709&number=0123 | |
| /control/compare/ | ?compare=[number] | Get the control changes between two publications Example: ?release=201402&compare=201709 | |
| Content | /content/table/ | ?depth=[depth] | Specify how deep to decend from document root. Example: ?depth=2 |
| /content/tree/ | ?depth=[depth] | Example: ?depth=2 | |
| /content/block/ | Never implemented | ||
| Module | Path | Switches | Description / Use | Example Link |
|---|---|---|---|---|
| Switch/Attribute Globals | ?release=[release] | Define the release-file to load. Most modules support defining this attribute, if not the default (latest publication) will be used. Example: ?release=202001 | none | |
| ?format=[format] | Optionally choose what 'format' of publications to get. Example: ?format=classic | |||
| ?drafts=[bool] | Optionally include any draft versions ofthe ISM which are being transcribed and unreleased. Example: ?drafts=1 | |||
| Content | /content/table/ | [DISABLED] | ||
| /content/tree/ | - | Provides a full document tree to reconstruct the publication or create a table of contents. | Tree | |
| /content/block/ | Still not implemented - lol | |||
| Releases | /releases/ | ?format=[format] | Get a list of the avaliable publications from JISM-XML files. |
Classic
Modern |
| /releases/detail | ?release=[release] | Using release switch, get Publication details from one release. | 2020-01 | |
| Control | /control/ | [DISABLED] | ||
| /control/list/ | ?release=[release] | Returns a all controls within the publication in natural order. | Latest | |
| control/classifications/ | ?release=[release] | Get the classification markings applicable to this publication. Example: ?release=201709 |
Default | |
| /control/compare/ | [DISABLED] - Use the /ism/compare/controls/ URL :-) | |||
| /control/words/ | - | Obtains all text from all Controls in the latest publication and returns a list of the frequency those words are used. | Words | |
| Strategy | /maturity/ | ?controls | Get a list of all controls that align with an Essential Eight Strategy. | Controls |
| /maturity/ | ?level=[maturity-level] | Get Details of an Essential Eight Maturity Level | Level 2 | |
Original APIv3 (OSCAL JSON) was Retired. This New version is acomplete re-write of APIv2 endpoints.
Responses are returned as JSON objects with a top-level wrapper containing module, request, and response keys. If the response contains a result array or object, a count field is also included.
Global query parameters:
?country=[country] - default au.?standard=[ism|pspf] - default is derived from the endpoint path (ism for most endpoints, pspf for /pspf/ paths).?release=[YYYY-MM] - selects a specific publication release; if omitted, the latest available release is used.Additional endpoint-specific parameters:
/marking/ supports ?get=[countries|country|alliances|alliance] and, for country lookups, ?country=[CODE].| Module | Path | Switches | Description / Use | Example Link |
|---|---|---|---|---|
| Publication | /publication/list/ | ?country=[country] ?standard=[ism|pspf] ?release=[YYYY-MM] | Get the available publications/releases for the selected country/standard. Defaults to the latest AUSTRALIAN ISM release. | Latest |
| Control | /control/list/ | ?country=[country] ?standard=[ism|pspf] ?release=[YYYY-MM] | Get the full control list for the selected release, including metadata, markings and maturity data. | List |
| /control/markings/ | ?country=[country] ?standard=[ism|pspf] ?release=[YYYY-MM] | Get the set of classification markings available for controls in the selected release. | Markings | |
| Marking | /marking/ | ?get=[countries|country|alliances|alliance] ?country=[CODE] | Get marking system data, country-level marking details, or alliance membership lists. | Default |
| PSPF | /pspf/releases/ | - | Get a list of available PSPF release metadata and the currently configured latest release. | PSPF Releases |
| /pspf/document/ | ?release=[YYYY-MM] | Get PSPF document content for a release, including domains, markings, applicability and framework structure. | Document | |
| /pspf/requirements/ | ?release=[YYYY-MM] | Get a parsed list of PSPF requirements for a release, keyed by requirement identifier. | Requirements | |
| Strategy | /maturity/essentialeight/ | - | Get the Essential Eight strategy listing for controls. | Essential Eight |
| Module | API Path | Attributes | Description / Use | Example |
|---|---|---|---|---|
| Global Attributes | &publication=[uid] | Define the publication UID to use for the query. When undefined, either returns all publication results or just the latest publication, depending on the module requested. | ||
| Publication | /publication/ | ?publication=[uid] | Get the details of the latest publication from the TISM Database, or a specifc publication if defined. | Latest |
| /publications/ | - | Returns a list of 'enabled' publications. | Enabled List | |
| /publication/outline/ | ?publication=[uid] | Get the hirachial outline of the latest publication, or a specific one if defined. | Outline | |
| Control | /control/ | ?index=[index] | Get a specific control using the index, from all publications that this control exists in. | Index 1234.1 |
| ?number=[number] | Gets most-recent revision of this control, using the number. | Control 1234 | ||
| ?number=[number]&publication=[uid] | Returns the control from a specific publication. | - | ||
| /control/list/ | - | Get a list of controls for a defined publication, or latest if 'publication' is undefined. | List | |
| /control/words | - | Obtains all text from all Controls in the latest publication and returns a list of the frequency those words are used. | Words | |
| Content | /content/ | - | Returns a list of Content objects from current (or specific) publication. | - |
| /content/blocks/ | - | Return a list of Blocks from a specific Content object. | - | |
| /content/block/ | - | Get a specific Block and all child Blocks. | - | |