---
title: "Pending, Failed and Rejected OS patches report"
method: GET
path: "/v2/queries/os-patches"
tags: ["queries"]
---

# Pending, Failed and Rejected OS patches report

`GET /v2/queries/os-patches`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/queries/os-patches`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/queries/os-patches/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns list of OS patches for which there were no installation attempts

## Query parameters

- `df` string
- `ts` string
- `status` string
- `type` string
- `severity` string
- `cursor` string
- `pageSize` integer

## Response `default`

default response

- object
  - `cursor` object
    - `name` string
    - `offset` integer
    - `count` integer
    - `expires` number, double
  - `results` object[]
    - `id` string, uuid: Identifier
    - `name` string: Name
    - `severity` string: Severity
    - `status` string: Status
    - `type` string: Type
    - `installedAt` number, double: Installation attempt timestamp
    - `deviceId` integer: Device identifier
    - `timestamp` number, double: Date/Time when data was collected/updated
    - `kbNumber` string: KB Number

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)