--- title: "Retrieve Sigma News Events for a given entity" method: POST path: "/entity/{entityURN}/news" tags: ["Monitoring: Entity Management"] --- # Retrieve Sigma News Events for a given entity `POST /entity/{entityURN}/news` This endpoint will return a paginated list of machine-curated Sigma News events for a given entity. ## Path parameters - `entityURN` string, required — The entity ID or URN. ## Query parameters - `page` integer — Page number, 1-indexed. Default: 1 - `pageSize` integer — Number of results per page. Maximum: 100, Default: 10 - `sortBy` string, nullable — The field name that you want to sort by. Many fields in the response are sortable, but not all. - `sortOrder` string, nullable — ASC or DESC. Defaults: DESC ## Request body - RequestEntityNewsRequestPublic - `filters` RequestEntityNewsFilters - `endTime` string - `eventEntityRisks` string[], nullable - `eventType` string - `eventTypes` string[], nullable - `isDecisionedAgainst` boolean — Only return news that has been marked accepted or decisioned against. - `languages` string[], nullable - `matchIDs` string[], nullable — An array of match IDs to include news from. - `matchNames` string[], nullable - `minMaterialityScore` number - `onlyReviewRequiredNews` boolean — Only return news that requires review. Causes isDecisionedAgainst to be ignored - `publisherCountries` string[], nullable - `publisherRegions` string[], nullable - `publisherSubRegions` string[], nullable - `startTime` string - `territories` string[], nullable - `yearsOfBirth` integer[], nullable - `page` integer — Page number, 1-indexed. Default: 1 - `pageSize` integer — Number of results per page. Maximum: 100, Default: 10 - `sortBy` string, nullable — The field name that you want to sort by. Many fields in the response are sortable, but not all. - `sortOrder` string, nullable — ASC or DESC. Defaults: DESC - `total` integer — Total number of results. Ignored in requests, used in responses. ## Response `200` OK - ResponseNews - `newsEvents` ResponseDecisionedNewsEvent[], nullable - `articles` SigmaidEventArticle[], nullable - `articleHash` string - `body` string — The full-text article body, if available - `extractedEntities` SigmaidExtractEntity[], nullable — Detected entities and highlights from the article body/title. This can be natural persons or entities. - `entityRisk` string — A measure of how culpable or involved the entity is in the event, based on the article text. Possible values are: 'Very High', 'High', 'Possible', 'Low', 'Unlikely', and 'Undetermined'. - `focalEntity` boolean — Marks if this extracted entity is the main entity of its event. Events have one focal entity, but articles may appear in different events with different focal entities.' - `highlights` SigmaidHighLightSection[] — Offsets of where the entity appears in the article body or title - `end` integer — The end of the detected entity name in the article. Relative to the beginning of the text. - `start` integer — The beginning offset of the detected entity name in the article. Relative to the beginning of the text. - `target` 'title' | 'body' — Determines whether the offsets should be applied to the title or body. - `labels` string[], nullable — Predicted entity types: PER, ORG, LOC, or MISC. - `text` string — The entity name detected in the article body - `yearsOfBirth` integer[], nullable — Birthdays of entities, if detected. This is a list of years, not a range. - `extractedRisks` SigmaidExtractedRisk[] — Highlight information for risky keywords or phrases in the article or title. - `category` string - `highlights` SigmaidHighLightSection[] — Offsets of where the entity appears in the article body or title - `end` integer — The end of the detected entity name in the article. Relative to the beginning of the text. - `start` integer — The beginning offset of the detected entity name in the article. Relative to the beginning of the text. - `target` 'title' | 'body' — Determines whether the offsets should be applied to the title or body. - `extractedTerritories` SigmaidExtractedTerritory[], nullable — Countries and major administrative divisions (e.g., states, provinces) mentioned in the article. - `adminOne` string, nullable — The first-level administrative division of the territory, if applicable. For example, a state in the US or a province in Canada. - `count` integer — The amount of times this territory was mentioned in the article - `country` string — The ISO 3166-1 alpha-2 country code of the territory - `evidence` string[], nullable — The snippets of the article that support a territory determination - `highlights` SigmaidHighLightSection[] — Offsets of where the entity appears in the article body or title - `end` integer — The end of the detected entity name in the article. Relative to the beginning of the text. - `start` integer — The beginning offset of the detected entity name in the article. Relative to the beginning of the text. - `target` 'title' | 'body' — Determines whether the offsets should be applied to the title or body. - `humanVerified` boolean — A small portion of articles have been manually verified by Sigma360 analysts, this field indicates whether the article has been verified adverse or not - `isPreferredPublisher` boolean — High-quality government gazettes, newspapers of record, or reputable news agencies are listed as preferred publishers. This field indicates whether the article is from a preferred publisher - `language` string — The ISO 639-1 two-letter language code of the article - `materialityScore` number — A ranking of how severe the event is, based on the article text. This is a number between 0 and 1, where 1 is the most severe. - `publishedDate` string, date-time — The date and time the article was published, in ISO 8601 format - `publisher` string — A human-readable name of the publisher - `publisherCountryCode` string — The ISO 3166-1 alpha-2 country code of the publisher's country. This is not the country of the event or journalist, but the country of the publisher's headquarters - `title` string — The article title - `topics` string[], nullable — A list of detected event topics, such as 'white_collar_crime' - `url` string — The article URL - `decisioning` ResponseDecisionState - `decidedByDefault` boolean - `decisionedAgainst` boolean - `hasDecision` boolean - `notes` string - `rationale` string[], nullable - `reviewSubmittedAt` string - `reviewedByUserName` string - `reviewedByUserURN` string - `wasDecisionMadeAgainstThisVersion` boolean - `decisioningTimeline` ResponseDecisionTimelineState[], nullable - `decidedByDefault` boolean - `decisionedAgainst` boolean - `notes` string - `rationale` string[], nullable - `reviewSubmittedAt` string - `reviewedByUserName` string - `reviewedByUserURN` string - `entityRisk` string - `eventConfidence` number - `eventLabel` string - `eventMaterialityScore` number - `eventSeverity` string - `humanVerified` boolean - `id` string - `isPreferredPublisher` boolean - `sigmaID` string - `topics` string[], nullable - `unformattedLabel` string - `page` integer — Page number, 1-indexed. Default: 1 - `pageSize` integer — Number of results per page. Maximum: 100, Default: 10 - `summary` ResponseNewsSummary - `eventEntityRisks` string[], nullable - `eventsSummary` ResponseEventSummary[], nullable - `eventType` string - `numArticles` integer - `numEvents` integer - `unformattedEventType` string - `languages` string[], nullable - `matchNames` string[], nullable - `matchesSummary` ResponseMatchSummary[], nullable - `highestEntityRisk` string - `matchName` string - `numEvents` integer - `yearOfBirth` integer, nullable - `publisherCountries` string[], nullable - `publisherRegions` string[], nullable - `publisherSubRegions` string[], nullable - `territories` string[], nullable - `yearsOfBirth` integer[], nullable - `total` integer — Total number of results. Ignored in requests, used in responses. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `429` — Too Many Requests - `500` — Internal Server Error --- [API](https://skmtc.dev/sigma360/apis/sigma360-api.md) · [All operations](https://skmtc.dev/sigma360/apis/sigma360-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sigma360/sigma360-api/revisions/fcdda6232c62/schema)