---
title: "Get current inventory suggestions list"
method: POST
path: "/suggestions/list"
tags: ["Suggestions"]
---

# Get current inventory suggestions list

`POST /suggestions/list`

## Request

- Base URL: `https://asm.cloud.tenable.com/api/1.0`
- URL: `https://asm.cloud.tenable.com/api/1.0/suggestions/list`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/tenable/apis/attack-surface-management/docs/suggestions/list/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `offset` integer
- `limit` integer, required
- `is_archived` boolean, required
- `sortby` string
- `sortorder` boolean

## Request body

- object[]: Applied filters, suggestions do not support complex queries
  - `column` string
  - `type` string
  - `value` string

## Response `200`

OK

- object
  - `suggestions` object[]
    - `id` number
    - `suggestion_text` string
    - `suggestion_type` string
    - `suggestion_details` object
      - `rules` object[]
        - `rule` string
        - `description` string
    - `created_at` string
    - `deleted_at` string
  - `total` number: Number of suggestions

## Other responses

- `401`: Unauthorized
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/tenable/apis/attack-surface-management.md) - [All operations](https://skmtc.dev/tenable/apis/attack-surface-management/llms.txt) - [OpenAPI document](https://skmtc.dev/tenable/apis/attack-surface-management/revisions/465c06285e48?raw)