GET /snds/ip_data

GET 
snds/ip_data

Retrieve detailed Microsoft SNDS data records for monitored IP addresses

Query Parameters

offset string
Number of items to skip before starting to return results

limit string
Maximum number of items to return per request

sort string
Example: -ip (desc) or ip (asc)

period_from string Required
Start of the time period. Use date-time without timezone because SNDS records are stored as calendar-date records with the timestamp set to the start of that day. Example: 2021-07-06T00:00:00.000Z. Do not send timezone offsets

period_to string Required
End of the time period. Use date-time without timezone because SNDS records are stored as calendar-date records with the timestamp set to the start of that day. Example: 2021-08-06T00:00:00.000Z. Do not send timezone offsets. The range between period_from and period_to must not exceed 30 days

ips string
Comma-separated list of IP addresses to filter by. Each value can be a full or partial match

rdns string
Comma-separated list of reverse DNS hostnames to filter by. Each value can be a full or partial match

profile_id string
Filter by profile ID

filter_result string
Comma-separated list of filter results to filter by

Returns

• dataarray
  • ipstring
    Sending IP address
  • date_timestampstring
    Date of the IP data record
  • dns_reverse_resultarray
    Reverse DNS lookup results for the IP address
    • rdnsstring
      Reverse DNS hostname
  • period_fromstring
    Start of the measurement period for this record
  • period_tostring
    End of the measurement period for this record
  • rcpt_commandsnumber
    Number of RCPT commands issued from this IP
  • data_commandsnumber
    Number of DATA commands issued from this IP
  • recipientsnumber
    Total number of recipients targeted from this IP
  • filter_resultstring
    Spam filter verdict for this IP
    Allowed values: GREEN, YELLOW, RED
  • bouncenumber
    Number of bounced messages from this IP
  • bounce_ratenumber
    Ratio of bounced messages to total messages sent
  • complaint_ratenumber
    Ratio of spam complaints to total messages delivered
  • trap_period_fromstring
    Start of the spam trap measurement period
  • trap_period_tostring
    End of the spam trap measurement period
  • trap_hitsnumber
    Number of spam trap hits recorded for this IP
  • sample_helostring
    Sample HELO value observed from this IP
  • sample_mail_fromstring
    Sample MAIL FROM address observed from this IP
  • commentsstring
    Additional comments or notes about this IP
• metaobject
  Pagination metadata for list responses
  • countinteger
    Total number of items available
  • offsetinteger
    Number of items skipped
  • limitinteger
    Maximum number of items returned per request

Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error