CEcensys
Exposure Management

List the assets of an attack surface

Changed on

Retrieve the assets that were added to an attack surface as seeds. Each asset is in the form you would send to add or remove it, except for types that cannot be named in a request (see type).<br><br>This endpoint does not cost credits to execute.

get/v1/attacksurfaces/{attack_surface_id}/assets

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v1/attacksurfaces/{attack_surface_id}/assets
  • Auth
    HTTP bearer

Path parameters

attack_surface_idstring required

The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.

Example:11111111-2222-3333-4444-555555555555

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555
page_sizeinteger

Maximum number of assets to return per page.

page_tokenstring

Pagination token from a previous response to retrieve the next page of results.

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

Response

Assets listed successfully

Example response

{
  "result": {
    "assets": [
      {
        "asset": "8.8.8.0/24"
      }
    ]
  }
}

Changes