---
title: "Retrieve a paginated list of entity history events"
method: POST
path: "/entity/{entityURN}/history"
tags: ["Monitoring: History"]
---

# Retrieve a paginated list of entity history events

`POST /entity/{entityURN}/history`

This endpoint will return a paginated list of entity history events for a given entity. A history event is created whenever an entity's data changes for any reason.

## 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

## Request body

- RequestEntityHistoryRequestPublic
  - `page` integer — Page number, 1-indexed. Default: 1
  - `pageSize` integer — Number of results per page. Maximum: 100, Default: 10
  - `total` integer — Total number of results. Ignored in requests, used in responses.

## Response `200`

OK

- ResponsePaginatedEntityHistory
  - `histories` ResponseEntityHistory[], nullable
    - `changedMatches` integer
    - `configurationChanges` ResponseConfigurationChanges
      - `dataChangeType` string
      - `dataChanges` ResponseChangedField[], nullable
        - `after` ResponseChangedItem[], nullable
          - `type` string
          - `value` string
        - `before` string[], nullable
        - `field` string
    - `currentSearchParams` SigmaidBasicSearchParams
      - `aliases` string[], nullable — Secondary names to perform a search on
      - `countries` string[], nullable — ISO 3166-1 alpha-2
      - `customFields` SigmaidCustomEntityField[], nullable — Optional. A list of custom fields to be associated with the entity for cross-referencing or disambiguation in alerts and monitoring. Does not affecting risk or matching logic. Each field must have a unique key.
        - `key` string
        - `value` string
      - `customerKey` string — Optional. A user-provided identifier that will be returned in alerts and monitoring. Any format.
      - `dob` string, nullable — Birth or foundation date. YYYY, YYYY-MM, YYYY-MM-DD, YYYY/MM or YYYY/MM/DD format.
      - `entityName` string, required — The primary name of the search
      - `entityType` 'person' | 'company' | 'aircraft' | 'vessel', nullable
    - `event` string
    - `externalDocumentLink` string
    - `historyID` integer
    - `indicatorChanges` ResponseIndicatorChange[], nullable
      - `category` string, required
      - `causalSigmaID` SigmaidSummarySearchResultRow
        - `aliases` string[], nullable
        - `birthDates` SigmaidDateWithSource[], nullable — Birth dates of the entity
          - `humanReadable` string, nullable — A human-readable representation of the range. Show in user interfaces instead of the date range if present
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `until` string, date-time, nullable — If the date is a range, the end of the range
          - `value` string, date-time — The date, or the start of a date range
        - `entityName` string
        - `entityType` string
        - `foundationDates` SigmaidDateWithSource[], nullable — Foundation dates of the entity
          - `humanReadable` string, nullable — A human-readable representation of the range. Show in user interfaces instead of the date range if present
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `until` string, date-time, nullable — If the date is a range, the end of the range
          - `value` string, date-time — The date, or the start of a date range
        - `hasIndirectOwners` boolean
        - `hasNetworkConnections` boolean
        - `indicatorSummaries` SigmaidIndicatorSummary[], nullable
          - `category` string
          - `count` integer
          - `isNetwork` boolean — Indicates whether the indicator is describes this entity or one of its network connections
          - `maxScore` integer
        - `locations` SigmaidLocation[], nullable
          - `address` string
          - `country` string
          - `countryCode` string
          - `fromDate` string
          - `locality` string
          - `majorAdministrativeDivision` string
          - `minorAdministrativeDivision` string
          - `postalCode` string
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `streetName` string
          - `streetNumber` string
          - `toDate` string
          - `type` string
        - `matchDOB` string
        - `matchLocation` string
        - `matchName` string
        - `matchStrength` number
        - `risk` SigmaidRiskSummary
          - `score` number
        - `sigmaID` string
        - `sources` SigmaidSourcesByIntegration[], nullable
          - `key` string
          - `lastUpdated` string, date-time, nullable
          - `matches` string[], nullable
          - `matchesOriginated` integer
          - `name` string
          - `ultimateSources` string[], nullable
      - `changeType` string
      - `code` string, required
      - `dataChanges` ResponseChangedField[], nullable
        - `after` ResponseChangedItem[], nullable
          - `type` string
          - `value` string
        - `before` string[], nullable
        - `field` string
      - `date` string, date-time, nullable
      - `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
      - `description` string, required
      - `extras` object, nullable — Extra details about the indicator
      - `hopsAway` integer, required
      - `name` string, required
      - `originatingSigmaID` string
      - `possibleSameAs` string
      - `primaryExtras` object, nullable — Extra details about the indicator, typical shown above the fold
      - `relationshipChain` SigmaidRelationshipChain
        - `edges` SigmaidEdge[], nullable
          - `edgeID` string — A unique identifier for this edge.
          - `extendedRelationshipData` SigmaidExtendedRelationshipData
            - `asOfDate` string — The date this relationship data was reported as of.
            - `currency` string — The currency of the monetary value.
            - `endDate` string — The date this relationship ended.
            - `former` boolean — Whether this relationship is no longer active.
            - `monetaryValue` string — The monetary value associated with this relationship.
            - `numShares` string — The number of shares held in this relationship.
            - `percent` string — The ownership or control percentage associated with this relationship.
            - `startDate` string — The date this relationship began.
            - `ultimateSources` string[], nullable — The original data sources for this relationship.
          - `fromNode` string — The SigmaID of the node that this edge starts from.
          - `inverseRelationship` string — The normalized relationship in the inverse direction.
          - `relationship` string — The normalized relationship, as determined by SigmaID's NLP models.
          - `relationshipDenotesOwnership` boolean — Whether this relationship imparts ownership or control. For example, 'Has Subsidiary' would have this field set to true, while 'Is Officer Of'' would have it set to false.
          - `toNode` string — The SigmaID of the node that this edge points to.
          - `unnormalizedRelationship` string — The raw text of the relationship as it appears in the source data.
        - `entities` SigmaidBasicEntityResult[], nullable
          - `entityName` string
          - `entityType` string
          - `sigmaID` string
      - `score` integer
      - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
      - `sources` SigmaidSourceURL[], nullable, required
        - `name` string
        - `url` string, nullable
      - `subcategory` string, required
      - `urn` string, required
    - `indicatorChangesSummary` ResponseIndicatorDiff[], nullable
      - `added` integer
      - `category` string
      - `deleted` integer
      - `isNetwork` boolean
      - `maxScore` integer
      - `updated` integer
    - `kycChanges` ResponseKYCChange[], nullable
      - `changeType` string
      - `dataChanges` ResponseChangedField[], nullable
        - `after` ResponseChangedItem[], nullable
          - `type` string
          - `value` string
        - `before` string[], nullable
        - `field` string
      - `sigmaID` string
    - `matchChanges` ResponseMatchChange[], nullable
      - `birthOrFoundationDates` string[], nullable
      - `changeType` string
      - `entityName` string
      - `locations` SigmaidLocation[], nullable
        - `address` string
        - `country` string
        - `countryCode` string
        - `fromDate` string
        - `locality` string
        - `majorAdministrativeDivision` string
        - `minorAdministrativeDivision` string
        - `postalCode` string
        - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
        - `streetName` string
        - `streetNumber` string
        - `toDate` string
        - `type` string
      - `sigmaID` string
    - `newsChanges` ResponseNewsChange[], 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
      - `changeType` string
      - `dataChanges` ResponseChangedField[], nullable
        - `after` ResponseChangedItem[], nullable
          - `type` string
          - `value` string
        - `before` string[], nullable
        - `field` string
      - `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
    - `numIndicators` ResponseDiffNumber
      - `new` integer
      - `old` integer
    - `numMatches` ResponseDiffNumber
      - `new` integer
      - `old` integer
    - `origin` string
    - `postEventSearchParams` SigmaidBasicSearchParams
      - `aliases` string[], nullable — Secondary names to perform a search on
      - `countries` string[], nullable — ISO 3166-1 alpha-2
      - `customFields` SigmaidCustomEntityField[], nullable — Optional. A list of custom fields to be associated with the entity for cross-referencing or disambiguation in alerts and monitoring. Does not affecting risk or matching logic. Each field must have a unique key.
        - `key` string
        - `value` string
      - `customerKey` string — Optional. A user-provided identifier that will be returned in alerts and monitoring. Any format.
      - `dob` string, nullable — Birth or foundation date. YYYY, YYYY-MM, YYYY-MM-DD, YYYY/MM or YYYY/MM/DD format.
      - `entityName` string, required — The primary name of the search
      - `entityType` 'person' | 'company' | 'aircraft' | 'vessel', nullable
    - `preEventSearchParams` SigmaidBasicSearchParams
      - `aliases` string[], nullable — Secondary names to perform a search on
      - `countries` string[], nullable — ISO 3166-1 alpha-2
      - `customFields` SigmaidCustomEntityField[], nullable — Optional. A list of custom fields to be associated with the entity for cross-referencing or disambiguation in alerts and monitoring. Does not affecting risk or matching logic. Each field must have a unique key.
        - `key` string
        - `value` string
      - `customerKey` string — Optional. A user-provided identifier that will be returned in alerts and monitoring. Any format.
      - `dob` string, nullable — Birth or foundation date. YYYY, YYYY-MM, YYYY-MM-DD, YYYY/MM or YYYY/MM/DD format.
      - `entityName` string, required — The primary name of the search
      - `entityType` 'person' | 'company' | 'aircraft' | 'vessel', nullable
    - `riskScore` ResponseDiffNumber
      - `new` integer
      - `old` integer
    - `timestamp` string, date-time
    - `urn` string
  - `page` integer
  - `pageSize` integer
  - `total` integer

## 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)