POST /filteringlog/getDetail

The /filtering/getDetail endpoint allows you to retrieve processing details for a specific message, based on its message ID.

Request

curl -X POST \
  'https://cloud.vadesecure.com/rest/v3.0/filteringlog/getDetail' \
  -H 'x-vrc-authorization: LOGIN:TOKEN' \
  -H 'Content-type: application/json' \
  --data '{
        "userId": your_accountID,
        "date": 1614947571000,
        "messageId": "4DsRw...Rz1vRB",
        "hostname":"vcfr1mtai06p.internal.vadesecure.com"
    }'; echo

x-vrc-authorization - Required

string

The authorization token that must be passed to the request for authorization.

The header value is the concatenation of:

authHeader = LOGIN:TOKEN

LOGIN corresponds to the login that was provided when retrieving the authorization token.
TOKEN corresponds to the content of the x-vrc-authorization header that was returned when retrieving the authorization token.

Accept

application/json

userId - Required: integer; Defines the unique Account ID the request should be applied to. This corresponds to the Account ID that was retrieved following the steps described in Retrieve Auth token and accountID.
date - Required: integer; The UNIX timestamp of the message in milliseconds provided in the initial response of POST /filteringlog/getReport.
messageId - Required: string; The unique message ID provided in the initial response of POST /filteringlog/getReport.
hostname - Required: string; The server that handled the message provided in the initial response of POST /filteringlog/getReport.

Response

200 OK application/json

The response body contains a JSON blob.

400 Error application/json

In case an error occurred, a 400 error is returned along with a JSON object containing a description of the error, typically:

{"error": "error description"}

401 Unauthorized application/json

There was a problem authenticating your request.

detail: string; The message processing details, provided as string.; It includes extra information compared to the ones provided through POST /filteringlog/getReport, such as the filter spamcause, which can be accessed in the cause= field of the string.
analysisInfo: string; (Deprecated). May contain information about sandboxing evaluation.
result: string; Indicates whether the analysis information could be returned or not, through OK or NOK.

{
    "analysisInfo": null,
    "detail": "id=<7ad63d01-2eb5-4995-b6bc-c...w)\r\n",
    "result": "OK"
}