GET /accounts/{account_id}/infrastructure/targets

Lists and sorts an account’s targets. Filters are optional and are ANDed together.

Servers

Path parameters

Name Type Required Description
account_id String Yes

Query parameters

Name Type Required Description
ips[] Array No

Filters for targets that have any of the following IP addresses. Specify ips multiple times in query parameter to build list of candidates.

hostname String No

Hostname of a target

virtual_network_id String No

Private virtual network identifier of the target

created_before String No

Date and time at which the target was created before (inclusive)

modified_before String No

Date and time at which the target was modified before (inclusive)

ipv4_end String No

Defines an IPv4 filter range's ending value (inclusive). Requires ipv4_start to be specified as well.

ipv6_start String No

Defines an IPv6 filter range's starting value (inclusive). Requires ipv6_end to be specified as well.

ipv6_end String No

Defines an IPv6 filter range's ending value (inclusive). Requires ipv6_start to be specified as well.

page Integer No

Current page in the response

Default value: 1

ip_v6 String No

IPv6 address of the target

order String No

The field to sort by.

Possible values:

  • "hostname"
  • "created_at"
direction String No

The sorting direction.

Possible values:

  • "desc"
  • "asc"
modified_after String No

Date and time at which the target was modified after (inclusive)

per_page Integer No

Max amount of entries returned per page

Default value: 1000

ip_v4 String No

IPv4 address of the target

ipv4_start String No

Defines an IPv4 filter range's starting value (inclusive). Requires ipv4_end to be specified as well.

target_ids[] Array No

Filters for targets that have any of the following UUIDs. Specify target_ids multiple times in query parameter to build list of candidates.

hostname_contains String No

Partial match to the hostname of a target

created_after String No

Date and time at which the target was created after (inclusive)

ip_like String No

Filters for targets whose IP addresses look like the specified string. Supports * as a wildcard character

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.