Skip to content
Skip to main content
GET
/v3/grants/{grant_id}/rule-evaluations

List rule evaluationsBeta

Returns a paginated list of rule evaluation records for the specified grant. Each record captures which rules were evaluated against an inbound message, SMTP envelope, or outbound send, the normalized sender or recipient data that was matched, which rules matched, and which actions were applied.

Rule evaluations are created automatically as inbound mail is processed and as outbound sends are evaluated, and serve as an audit trail for the Rules engine. Records are returned in reverse chronological order (most recent first).

NYLAS API KEY

Parameters

Path parameters

grant_id*string

The ID of the grant to list rule evaluations for.

Query parameters

limitinteger

The maximum number of objects to return. See Pagination for more information.

Default: 50
page_tokenstring

A cursor to fetch the next page of results. Use the next_cursor value from the previous response.

Responses

request_idstring

ID of the request.

Example: "5fa64c92-e840-4357-86b9-2aa364d35b88"
dataarray<object>
next_cursorstring

A cursor for paginating through results. Present when there are more results; pass this value as page_token in the next request.

Example: "eyJsYXN0X2lkIjoiYjIzZGM0NWUtNjdmOC05MDEyLWJjZGUtMzQ1Njc4OWFiY2RmIn0="
GEThttps://api.us.nylas.com/v3/grants/{grant_id}/rule-evaluations?limit=50

Find your API key in the Nylas Dashboard under API Keys in your application settings.

grant_idrequiredstring

The ID of the grant to list rule evaluations for.

limitinteger

The maximum number of objects to return. See Pagination for more information.

page_tokenstring

A cursor to fetch the next page of results. Use the next_cursor value from the previous response.