API Reference

API URL (HTTPS only)

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

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

Authentication

To use the DSPM 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.

Next, generate a JWT token. POST an 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>

Offset and Limit

By default, the amount of records returned on an API call is 100, with a maximum of 1000 records. You can use the offset and limit filter options to retrieve records past the default 100.

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