Securonix Device Monitoring API

List of monitored devices and metadata.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/securonix-device-monitoring-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

securonix-device-monitoring-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Device Monitoring API
  description: Allows users to get a list of monitored devices and their ingestion-health metadata details.
  version: 1.0.0
servers:
- description: SwaggerHub API Auto Mocking
  url: https://virtserver.swaggerhub.com/securonix-b7a/Device_Monitoring/1.0.0
- url: https://{tenantId}.securonix.net/Snypr/ws
  description: Securonix server
  variables:
    tenantId:
      default: test_tenant
security:
- tokenAuth: []
tags:
- name: Device Monitoring
  description: List of monitored devices and metadata.
paths:
  /devicealert/listdevices:
    post:
      tags:
      - Device Monitoring
      summary: List monitored devices
      description: Get a list of monitored devices and your ingestion health metadata details.
      operationId: listMonitoredDevices
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DevicesRequest'
            examples:
              basicPagination:
                summary: Pagination and sorting
                value:
                  max: 10
                  offset: 0
                  status: Trusted
                  sort: device
                  order: desc
              searchByDevice:
                summary: Search by device identifier (exact match)
                value:
                  searchUserText: c2040l0232n
                  searchAttrs: device
                  operator: equals
                  status: Trusted
              searchByDeviceContains:
                summary: Search by device identifier (contains)
                value:
                  searchUserText: Starting
                  searchAttrs: device
                  operator: contains
                  status: Trusted
              searchByDatasource:
                summary: Search by datasource name
                value:
                  searchUserText: TestDs
                  searchAttrs: rgname
                  operator: contains
                  status: Trusted
              searchByStatus:
                summary: Search by device state
                value:
                  searchUserText: INACTIVE
                  searchAttrs: device_state
                  operator: equals
                  status: Trusted
              searchByTenant:
                summary: Search by tenant name (Applicable for MSSPs)
                value:
                  searchUserText: test_tenant
                  searchAttrs: tenantname
                  operator: equals
                  status: Trusted
              searchByFunctionality:
                summary: Search by functionality
                value:
                  searchUserText: Unix / Linux / AIX
                  searchAttrs: functionality
                  operator: equals
                  status: Trusted
      responses:
        '200':
          description: Successfully retrieved the monitored device list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListDevicesResponse'
              examples:
                success:
                  summary: Sample successful response
                  value:
                  - rgDevice: SubTenant1_59_ARSiluGMS
                    rgId: 59
                    rgName: Test_resource - BCD
                    tenantId: 1
                    tenantName: SubTenant1
                    lastDetectedTime: 1714541431331
                    deviceCreatedTime: 1713311431454
                    device: ARSiluGMS
                    typeSyslog: false
                    status: Active
                    functionality: Access / Identity Management
                  - rgDevice: SubTenant2_1431_GMSiluARS
                    rgId: 1431
                    rgName: Test_resource- BCD
                    tenantId: 1
                    tenantName: SubTenant2
                    lastDetectedTime: 1714541431331
                    deviceCreatedTime: 1713311431454
                    device: GMSiluARS
                    typeSyslog: true
                    status: Inactive
                    functionality: Access / Identity Management
                    threshold: 1440
                    modifiedDate: 08/12/2025 16:00:00
                    notificationType: Incident
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  responses:
    Unauthorized:
      description: Unauthorized - missing or invalid token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: Forbidden - insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Bad request - invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ListDevicesResponse:
      type: array
      items:
        $ref: '#/components/schemas/Device'
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Invalid request parameters
        code:
          type: string
          example: BAD_REQUEST
      required:
      - error
      - code
      additionalProperties: false
    Device:
      type: object
      properties:
        rgDevice:
          type: string
          description: Unique identifier for the device
          example: SubTenant1_59_machine1
        rgId:
          type: integer
          description: Resource Group ID
          example: 59
        rgName:
          type: string
          description: Resource Group name
          example: Test_resource
        tenantId:
          type: integer
          description: Tenant ID
          example: 1
        tenantName:
          type: string
          description: Tenant name
          example: SubTenant1
        lastDetectedTime:
          type: integer
          description: Last event timestamp
          example: 1754101802444
        deviceCreatedTime:
          type: integer
          description: Timestamp the time the device was created
          example: 1754101802444
        device:
          type: string
          description: Device name
          example: machine1
        typeSyslog:
          type: boolean
          description: Indicates whether the datasource is a syslog device or not.
          example: false
        status:
          type: string
          description: Device Notification State
          enum:
          - Active
          - Inactive
          - Not Configured
          example: Not Configured
        functionality:
          type: string
          description: Functionality of the data source
          example: Access / Identity Management
        threshold:
          type: integer
          description: Notification threshold in minutes
          example: 1440
        modifiedDate:
          type: string
          description: Notification configuration last modified Date
          example: 08/12/2025 16:00:00
        notificationType:
          type: string
          description: Notification Type Incident or Email
          example: Incident
      additionalProperties: false
    DevicesRequest:
      type: object
      properties:
        max:
          type: integer
          description: Maximum number of results to return
          example: 10
        offset:
          type: integer
          description: Number to offset the pagination by
          example: 0
        status:
          type: string
          description: Fetch devices based on current status
          enum:
          - Trusted
          - Muted
          example: Trusted
        sort:
          type: string
          description: The attribute to filter results by
          enum:
          - device
          - rgname
          - functionality
          - device_state
          - tenantname
          example: device
        order:
          type: string
          description: The order items should be sorted and listed by
          enum:
          - asc
          - desc
          example: desc
        searchUserText:
          type: string
          description: The search query
          example: c2040l0232n
        searchAttrs:
          type: string
          description: The device's searched attribute
          enum:
          - device
          - rgname
          - functionality
          - device_state
          - tenantname
          example: device
        operator:
          type: string
          description: The operator used in the search
          enum:
          - equals
          - contains
          example: contains
      required:
      - status
      additionalProperties: false
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: token
      description: Authentication token.