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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

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'
    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'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Bad request - invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Invalid request parameters
        code:
          type: string
          example: BAD_REQUEST
      required:
      - error
      - code
      additionalProperties: false
    ListDevicesResponse:
      type: array
      items:
        $ref: '#/components/schemas/Device'
    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.