v1

latestOpenAPI 3.1.02026-08-042010999.7 KB
Monitoring: Entity Management

Retrieve Sigma News Events for a given entity

This endpoint will return a paginated list of machine-curated Sigma News events for a given entity.

post/entity/{entityURN}/news

Path parameters

entityURNstring required

The entity ID or URN.

Example:urn:sigma:entity:1234-abcdef

The entity ID or URN.

Query parameters

pageinteger

Page number, 1-indexed. Default: 1

Example:1

Page number, 1-indexed. Default: 1

pageSizeinteger

Number of results per page. Maximum: 100, Default: 10

Example:10

Number of results per page. Maximum: 100, Default: 10

sortBystring nullable

The field name that you want to sort by. Many fields in the response are sortable, but not all.

The field name that you want to sort by. Many fields in the response are sortable, but not all.

sortOrderstring nullable

ASC or DESC. Defaults: DESC

Example:asc

ASC or DESC. Defaults: DESC

Request body

pageinteger

Page number, 1-indexed. Default: 1

pageSizeinteger

Number of results per page. Maximum: 100, Default: 10

sortBystring nullable

The field name that you want to sort by. Many fields in the response are sortable, but not all.

sortOrderstring nullable

ASC or DESC. Defaults: DESC

totalinteger

Total number of results. Ignored in requests, used in responses.

Example request

{
  "page": 1,
  "pageSize": 10,
  "sortOrder": "asc",
  "total": 15000
}

Response

OK

pageinteger

Page number, 1-indexed. Default: 1

pageSizeinteger

Number of results per page. Maximum: 100, Default: 10

totalinteger

Total number of results. Ignored in requests, used in responses.

Example response

{
  "newsEvents": [
    {
      "articles": [
        {
          "publisher": "New York Times"
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 15000
}