---
title: "List of Sources"
method: GET
path: "/sources"
tags: ["Sources"]
---

# List of Sources

`GET /sources`

## Request

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

Retrieve a list of sources in your inventory.

## Query parameters

- `offset` integer
- `limit` integer, required
- `sortby` 'abc' | 'count' | 'count_asc' | 'txt_count' | 'txt_count_asc' | 'recency'
- `search` string

## Response `200`

Returned if Tenable Attack Surface Management successfully returned the list of sources.

- object
  - `searches` object[]: Result source data in an array
    - `id` integer, required: The ID of the source
    - `keyword` string, required: The keyword that was added when the source was created
    - `search_type` 'keyword' | 'domain' | 'ip' | 'iprange' | 'moved' | 'literal' | 'cloudflare' | 'aws' | 'gcp' | 'azure' | 'asn', required: The type of the sources: * keyword - Keyword source type * domain - Domain source type * ip - IP address source type * iprange - IP address range source type * moved - Source type for assets that were moved from other inventories * literal - Literal source type * cloudflare - Cloudflare source type * aws - AWS source type * gcp - Google Cloud Platform * azure - Microsoft Azure
    - `searchparams` string: Legacy property
    - `dbdate` integer: The dbdate of the source
    - `results_count` integer, required: The number of results in the source
    - `results_fetched` integer, required: The number of fetched results in the source
    - `company_id` integer, required: The ID of the sources' inventory
    - `created_at` string, date-time, required: Timestamp of the creation of the source
    - `updated_at` string, date-time: Timestamp of the last update that happended on the source
    - `deleted_at` string, date-time: Timestamp when the source was deleted
    - `screenshot` string: URL that points to the screenshot of the source
    - `limited_result` 0 | 1, required: A flag that indicates if the source has reached the limits defined by the license.
    - `txt_records_fetched` integer, required: The number of TXT records fetched for the source
    - `is_elastic` boolean, required: Indicates whether or not the source is an elastic source or not
  - `total` integer: Count of the total number of sources in your inventory

## Other responses

- `400`: Returned if your request specified invalid parameters or if your request was improperly formatted.
- `401`: Returned if you do not have permissions to use this endpoint.
- `500`: Returned if an internal error occurred in Tenable Attack Surface Management

---

[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)