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/mcafee-devices-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: Mcafee Devices API
  contact:
    name: McAfee Support
    url: https://www.mcafee.com/enterprise/en-us/support.html
  termsOfService: https://www.mcafee.com/enterprise/en-us/about/legal/terms-of-use.html
  version: '1.0'
  description: 'Operations tagged Devices across 2 of this provider''s published API definitions: mcafee-esm-openapi.yml, mcafee-mvision-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{esm-server}/rs/esm
  description: McAfee ESM Server
  variables:
    esm-server:
      default: your-esm-server
      description: Hostname or IP of the ESM server
- url: https://api.mvision.mcafee.com
  description: MVISION Cloud Production
tags:
- name: Devices
  description: Manage ESM device hierarchy
paths:
  /v2/devGetDeviceList:
    post:
      operationId: getDevices
      summary: McAfee List ESM devices
      description: Retrieve the list of devices in the ESM device hierarchy, including receivers, ELM, ACE, DEM, and ADM components.
      tags:
      - Devices
      responses:
        '200':
          description: List of ESM devices
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EsmDevice'
        '401':
          description: Not authenticated
      security:
      - sessionAuth: []
    servers:
    - url: https://{esm-server}/rs/esm
      description: McAfee ESM Server
      variables:
        esm-server:
          default: your-esm-server
          description: Hostname or IP of the ESM server
  /edr/v2/devices:
    get:
      operationId: listDevices
      summary: McAfee List managed devices
      description: Retrieve a paginated list of all devices managed by MVISION, including their health status, agent version, and last check-in time.
      tags:
      - Devices
      parameters:
      - name: filter[hostName]
        in: query
        required: false
        description: Filter devices by hostname
        schema:
          type: string
      - name: filter[os]
        in: query
        required: false
        description: Filter devices by operating system
        schema:
          type: string
      - name: filter[healthStatus]
        in: query
        required: false
        description: Filter by device health status
        schema:
          type: string
          enum:
          - healthy
          - unhealthy
          - inactive
      - $ref: '#/components/parameters/pageLimit'
      - $ref: '#/components/parameters/pageOffset'
      responses:
        '200':
          description: Paginated list of devices
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/DeviceListResponse'
        '401':
          description: Unauthorized
      security:
      - bearerAuth: []
    servers:
    - url: https://api.mvision.mcafee.com
      description: MVISION Cloud Production
  /edr/v2/devices/{deviceId}:
    get:
      operationId: getDevice
      summary: McAfee Get a specific device
      description: Retrieve detailed information about a specific managed device, including installed products, agent version, and security posture.
      tags:
      - Devices
      parameters:
      - name: deviceId
        in: path
        required: true
        description: Unique device identifier
        schema:
          type: string
      responses:
        '200':
          description: Device details
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/DeviceResponse'
        '401':
          description: Unauthorized
        '404':
          description: Device not found
      security:
      - bearerAuth: []
    servers:
    - url: https://api.mvision.mcafee.com
      description: MVISION Cloud Production
components:
  schemas:
    EsmDevice:
      type: object
      properties:
        id:
          type: integer
          description: Device ID
        name:
          type: string
          description: Device name
        ipAddress:
          type: string
          description: Device IP address
        type:
          type: string
          enum:
          - ESM
          - Receiver
          - ELM
          - ACE
          - DEM
          - ADM
          description: Device type in the ESM hierarchy
        status:
          type: string
          description: Device operational status
        model:
          type: string
          description: Hardware or virtual model
    Device:
      type: object
      properties:
        id:
          type: string
          description: Unique device ID
        type:
          type: string
          enum:
          - devices
        attributes:
          type: object
          properties:
            hostName:
              type: string
              description: Device hostname
            ipAddress:
              type: string
              description: Device IP address
            os:
              type: string
              description: Operating system
            osVersion:
              type: string
              description: Operating system version
            agentVersion:
              type: string
              description: MVISION agent version
            healthStatus:
              type: string
              enum:
              - healthy
              - unhealthy
              - inactive
              description: Device health status
            lastCheckIn:
              type: string
              format: date-time
              description: Last agent check-in time
            tags:
              type: array
              items:
                type: string
              description: Applied tags
    PaginationMeta:
      type: object
      properties:
        totalCount:
          type: integer
          description: Total number of matching records
        pageLimit:
          type: integer
          description: Current page size limit
        pageOffset:
          type: integer
          description: Current offset
    DeviceListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Device'
        meta:
          $ref: '#/components/schemas/PaginationMeta'
    DeviceResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/Device'
  parameters:
    pageLimit:
      name: page[limit]
      in: query
      required: false
      description: Maximum number of results to return per page
      schema:
        type: integer
        default: 20
        maximum: 100
    pageOffset:
      name: page[offset]
      in: query
      required: false
      description: Number of results to skip for pagination
      schema:
        type: integer
        default: 0
  securitySchemes:
    sessionAuth:
      type: apiKey
      in: cookie
      name: JWTToken
      description: Session token obtained from the login endpoint
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: OAuth 2.0 bearer token from client credentials grant
x-refined-from:
- mcafee-esm-openapi.yml
- mcafee-mvision-openapi.yml