---
title: "Real-time Single Screening"
method: POST
path: "/screening/full-single"
tags: ["One-Off Screening"]
---

# Real-time Single Screening

`POST /screening/full-single`

This endpoint is used to perform a screen of a single entity. It is done synchronously and returns a summary of the results. You must specify a filter set, which will be used for this search. The fields, coverage, and match threshold are determined by the filterset.

## Request body

- RequestFullSingleScreeningRequestPublic
  - `aliases` string[], nullable — Secondary names to perform a search on
  - `countries` string[], nullable — ISO 3166-1 alpha-2
  - `createAlerts` boolean, nullable — Optional. If true, alerts will be generated for this query if the results contain risk. Alerts are available in the UI or through webhook notifications.
  - `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
  - `filterSetID` integer, required — The Filter Set to use for this search. You may create and view your filtersets in the UI, under Settings > Filter Sets..

## Response `200`

OK

- ResponseFullSearchResultWithAlertPubliclyDocumented
  - `alertCreatedURN` string — Populated if the search resulted in an alert being created. Contains the URN of the alert. Only valid if using createAlerts=true in the request.
  - `resultCount` integer, required — Number of individual matches found
  - `resultRows` SigmaidCompositeResult[], nullable, required
    - `entity` SigmaidEntityResult, required
      - `KYC` SigmaidKYCEntityData, required
        - `aliases` SigmaidTextWithSource[], nullable
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `value` string
        - `facts` SigmaidFact[], nullable
          - `label` string
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `value` 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
        - `telephones` SigmaidTextWithSource[], nullable
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `value` string
        - `websites` SigmaidTextWithSource[], nullable
          - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `value` string
      - `entityName` SigmaidTextWithSource, required
        - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
        - `value` string
      - `facet` SigmaidFullEntityFacet, required
        - `aircraft` SigmaidFacetAircraft
          - `manufactureDates` SigmaidDateWithSource[], nullable
            - `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
          - `models` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `operators` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `otherIdentifiers` SigmaidIdentification[], nullable
            - `country` string, nullable
            - `extras` object, nullable
            - `label` string
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `serialNumbers` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `tailNumbers` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
        - `company` SigmaidFacetCompany
          - `corporateNumbers` SigmaidCorporateNumber[], nullable
            - `country` string[], nullable
            - `number` string
            - `register` string[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
          - `economicActivities` object, nullable
          - `foundedDates` SigmaidDateWithSource[], nullable
            - `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
          - `incorporationTypes` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `linesOfBusiness` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `statuses` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
        - `person` SigmaidFacetPerson
          - `dobs` SigmaidDateWithSource[], nullable
            - `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
          - `genders` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `identifications` SigmaidIdentification[], nullable
            - `country` string, nullable
            - `extras` object, nullable
            - `label` string
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `nationalities` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `politicalPositions` SigmaidPoliticalPosition[], nullable
            - `country` string
            - `description` string
            - `from` string, nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `to` string, nullable
        - `type` integer
        - `vessel` SigmaidFacetVessel
          - `imo` SigmaidTextWithSource
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `maritimeCallSigns` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `portsOfRegistry` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
          - `types` SigmaidTextWithSource[], nullable
            - `sourceAttribution` string[], nullable — Not human readable. This can be used to look up against source information objects.
            - `value` string
      - `indicatorSummaries` SigmaidIndicatorSummary[], required
        - `category` string
        - `count` integer
        - `isNetwork` boolean — Indicates whether the indicator is describes this entity or one of its network connections
        - `maxScore` integer
      - `indicators` SigmaidIndicator[], nullable, required
        - `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
        - `code` string, required
        - `date` string, date-time, nullable
        - `description` string, required
        - `extras` object, nullable — Extra details about the indicator
        - `hopsAway` integer, required
        - `name` string, required
        - `originatingSigmaID` 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
              - …
            - `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
      - `news` SigmaidNewsEvent[], nullable, required
        - `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
              - …
            - `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
              - …
          - `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
              - …
          - `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
        - `entityRisk` string
        - `eventConfidence` number
        - `eventLabel` string
        - `eventMaterialityScore` number
        - `eventSeverity` string
        - `humanVerified` boolean
        - `id` string
        - `isPreferredPublisher` boolean
        - `sigmaID` string
        - `topics` string[], nullable
        - `unformattedLabel` string
      - `riskSummary` SigmaidRiskSummary, required
        - `score` number
      - `sigmaID` string, required
    - `matchDOB` string
    - `matchLocation` string
    - `matchName` string
    - `matchStrength` number
    - `networkRiskSummary` SigmaidNetworkRiskResult
      - `edges` SigmaidEdge[], nullable — The relationships between the entities in the network. Each relationship connects two entities in the Nodes list.
        - `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.
      - `nodes` SigmaidNode[], nullable — The individual entities that are part of the network of the requested entity.
        - `entity` 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
        - `entityType` string — The type of the entity (e.g. person, company, vessel, aircraft).
        - `id` string — The SigmaID of the entity represented by this node.
        - `isDisabled` boolean — Whether the node is disabled due to filters or other factors. However, it may still be included because it is required to show a further node.
        - `name` string — The SigmaID's canonical name.
      - `properties` SigmaidNetworkRiskProperties
        - `relationships` string[], nullable
    - `sources` SigmaidSourcesByIntegration[], nullable
      - `key` string
      - `lastUpdated` string, date-time, nullable
      - `matches` string[], nullable
      - `matchesOriginated` integer
      - `name` string
      - `ultimateSources` string[], nullable
  - `searchDate` string, date-time, required

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