DOdomaintools
Newly Observed Domains Feed

End/cancel a feed session

Ends a session previously started with the NOD feed.

Requires a valid sessionID query parameter. If the session does not exist, a 404 response is returned.

delete/v1/feed/nod/

Request

Query parameters

sessionIDstring

Unique, client-generated session identifier for incremental feed retrieval.

Requirements:

  • 1 to 64 characters in length

  • Alphanumeric characters and hyphens only

  • Case-sensitive

Use a new value to start a new session; reuse the same value to resume a session and fetch additional results.

If omitted, time window parameters (such as after/before) are required.

Example:mySOC

A string that serves as a unique identifier for the session, used for resuming data retrieval from the last point.

Use a new sessionID to begin a new session, fetching the most recent hour by default. Add fromBeginning=true on only the first request to start from the earliest available hour instead.

Reuse the same sessionID to return all feed data since your last request.

If an API call returns an HTTP 206 response, repeat the same request with the same sessionID to receive the next tranche of results, until an HTTP 200 response is returned, indicating all results have been delivered.

If omitted, time window parameters (such as after/before) are required.

api_usernamestring

Only required for HMAC authentication.

Your DomainTools API username.

signaturestring

Hex-encoded HMAC signature computed over the string api_username + timestamp + request_path using the API key and a supported algorithm (MD5, SHA1, or SHA256) as the HMAC secret. For example, if using SHA256, compute:

hex(HMAC_SHA256(api_key, api_username + timestamp + "/v1/feed/nad/"))

and pass that as ?signature=….

timestampstring

Only required for HMAC authentication.

Current UTC timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Used to prevent replay attacks; the server will reject timestamps outside an allowed window.

app_partnerstring

Your product or integration name.

app_namestring

Appliance/module/playbook name

app_versionstring

Your product or integration version.

Response

Session deleted successfully (empty response body).

EmptyResponse nullable required

Empty object returned when no content is required in the response body.

Example response

{}

Changes

No recorded changes to this operation across all 1 revision of this API.