ScreenlyyIDDocs
Docs › API reference › Device verification

Host reputation

Checks the reputation of a host.

POSThttps://api.screenlyyid.com/api/v1/host-reputation-verify

Headers#

NameTypeRequiredDescription
x-api-keystringYesYour ScreenlyyID API key
x-correlation-idstring (uuid)NoCorrelation ID for this customer check

Request body#

FieldTypeRequiredDescription
HoststringNo
ListRatinginteger (int32)Yes
Zonesinteger (int32)No

Responses#

StatusDescription
200Successful response

Response body (200)#

FieldTypeRequiredDescription
HostInfosarray of objectNo
ListCountinteger (int64)Yes
HoststringNo
IsListedbooleanYes

Code samples#

curl --request POST \
  --url 'https://api.screenlyyid.com/api/v1/host-reputation-verify' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-correlation-id: YOUR_CORRELATION_ID' \
  --header 'Content-Type: application/json' \
  --data '{
  "Host": "<Host>",
  "ListRating": 1,
  "Zones": 1
}'