API Reference

API URL (HTTPS only)

The base URL for all DSPM API endpoints is https://api3.normalyze.io/

This API is only available over HTTPS. Accessing over HTTP will yield a 404 for all requests.

Authentication

To use this API, you must first get a JWT token from DSPM. To do this, get your API Credentials from the DSPM Web UI. See API Keys for further details.

Then generate a JWT token. POST API call to the DSPM API /config/api/token endpoint with the following JSON body:

{
    "apiKey": "your API key here",
    "apiSecret": "your API secret here"
}

When using the API directly, provide the API token in an Authorization header, preceded by Bearer):

authorization: Bearer <your JWT here>

Offet and Limit

The amount of records that are returned on any given API call by default is 100, with a maximum of 1000 records. To get records past the default 100 you can use the offset and limit filter options.

Example: To get a specific list of risks above the first 100 records you could use the offset and limit filter options.

https://api3.normalyze.io/risk/api/riskitems?offset=101&limit=200