Skip to content
Developers
Back to Steward

Create a manual screening hit

POST
/api/v1/screening/hits

Authorizations

Section titled “ Authorizations ”

Request Bodyrequired

Section titled “ Request Bodyrequired ”
Media type application/json
object
applicationId
required
string
individualId
string
businessId
string
title
required
string
description
string
url
string
publishingDate
string
summary
string
type
required
string
Allowed values: ADVERSE_MEDIA SANCTIONS WARNING PEP
status
required
string
Allowed values: IN_REVIEW CONFIRMED DISMISSED NOT_REVIEWED TRUE_MATCH FALSE_POSITIVE
Examples
{
  "applicationId": "507f1f77bcf86cd799439011",
  "individualId": "507f1f77bcf86cd799439012",
  "title": "",
  "description": "",
  "url": "",
  "publishingDate": "",
  "summary": "",
  "type": "ADVERSE_MEDIA",
  "status": "IN_REVIEW"
}

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”
Media type application/json
object
id
required
string
entityId

Entity ID (individualId or businessId)

string
type
required
string
Allowed values: ADVERSE_MEDIA SANCTIONS WARNING PEP
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
status
required
string
Allowed values: IN_REVIEW CONFIRMED DISMISSED NOT_REVIEWED TRUE_MATCH FALSE_POSITIVE
source
required
string
details
required

Raw screening hit details from the provider

object
updatedBy
string
enriched
required
boolean
matchResult
object
isMatch
required
boolean
confidence
required
number
reviewNote
required
string
matchExplanation
string
incidentSummary
required
string
riskLevel
required
string
severity
string
nullable
tierRationale
string
nullable
clearedReason

Why an automated pass cleared this hit, as a discrete value. Null while the hit is not cleared, on a reviewer’s own ruling, and on hits cleared before the reason was stored.

string
Allowed values: IDENTITY_MISMATCH NOTHING_ADVERSE_REPORTED SEARCH_RESULT_NOT_IDENTIFIED SOURCE_PAGE_UNREADABLE CONFIDENCE_BELOW_THRESHOLD NOMINAL_ROLE
categories
required
Array<object>
object
label
required
string
description

Concise (≤12 word) description of the risk type shown on the (i) hover

string
nullable
note
string
nullable
individualId
string
groupId

Id of the screening group this hit belongs to.

string
nullable
storyId

Deprecated alias for groupId on adverse-media hits.

string
nullable
notes
Array<object>
object
id
required
string
entityType
required
string
Allowed values: APPLICATION SCREENING_HIT DOCUMENT WORKFLOW_VERSION AUDIT_LOG
entityId
required
string
content
required
string
createdBy
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
deleted
required
boolean
createdByUser
required
object
id
required
string
externalId
required
string
firstName
required
string
lastName
required
string
email
required
string
title
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
updatedByUser
required
object
id
required
string
externalId
required
string
firstName
required
string
lastName
required
string
email
required
string
title
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
origin

Which screen raised this hit. Null for hits written before origin was recorded.

string
Allowed values: INITIAL_SCREENING ONGOING_MONITORING
Examples
{
  "id": "507f1f77bcf86cd799439011",
  "type": "ADVERSE_MEDIA",
  "createdAt": "2026-03-30T12:00:00.000Z",
  "updatedAt": "2026-03-30T12:00:00.000Z",
  "status": "IN_REVIEW",
  "source": "manual",
  "details": {
    "title": "Adverse media article",
    "description": "Subject mentioned in connection with financial fraud investigation",
    "url": "https://example.com/article",
    "publisher": "example.com",
    "publishingDate": "2022-03-17"
  },
  "updatedBy": "60d5ecb54b24003a7c8e92b2",
  "enriched": true,
  "matchResult": {
    "isMatch": false,
    "confidence": 1,
    "reviewNote": "Subject linked to money laundering investigation",
    "matchExplanation": "",
    "incidentSummary": "",
    "riskLevel": "",
    "severity": null,
    "categories": []
  },
  "note": null,
  "individualId": "507f1f77bcf86cd799439012",
  "groupId": null,
  "storyId": null,
  "origin": null
}