---
title: "Get the subscription history by ID"
method: GET
path: "/smartfolder/{id}/history"
tags: ["Subscriptions"]
---

# Get the subscription history by ID

`GET /smartfolder/{id}/history`

## Request

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

## Path parameters

- `id` integer, required

## Response `200`

OK

- object
  - `history` object[]
    - `smartfolderday` string, date-time
    - `added` integer
    - `removed` integer
    - `sum` integer

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was 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)