The IPS API offers GET and POST methods to request IPS data or to import data into IPS. It can be used both in SOAP and RESTful mode.

This API reference explains each of the API endpoints, with example REST requests and responses included.

Note: The HTTP requests in the reference are in format https://[hostname:port]/IPSAPIService/xxx. This format may vary in your own environment, depending on whether HTTP or HTTPS is used, and on the name of the web application specified during installation.

To use the IPS API, you need to include a token with each call (a GUID that is associated with one or more API operations). You can create new IPS API tokens using the IPS API Management App and associate them with the API methods you want to use. Fore more information, see the IPS API Administrator Guide.

The table below gives an overview of the HTTP response codes. For more specific error information, see the relevant endpoint reference page.

If an error or a code other than HTTP 200 is returned, see the response body for details. The format of a JSON error response body is shown below.

    {
      Errors: [
        {
          "Code": 1,
          "Message": "Error message 1"
        },
        {
          "Code": 2,
          "Message": "Error message 2"
        }
      ]
    }