Dow Jones Risk Search API
Ad-hoc search across Dow Jones Risk & Compliance profiles (Watchlist, State-Owned Companies, Adverse Media).
OpenAPI Specification
{
"openapi": "3.0.0",
"info": {
"description": "Risk and Compliance APIs",
"version": "v2",
"title": "Risk and Compliance APIs",
"contact": {
"name": "Dow Jones"
},
"license": {
"name": "Dow Jones"
}
},
"servers": [
{
"url": "https://api.dowjones.com"
},
{
"url": "https://eu.api.dowjones.com"
}
],
"paths": {
"/riskentities/search": {
"post": {
"security": [
{
"Bearer": []
}
],
"tags": [
"Risk and Compliance search"
],
"summary": "Screening of Risk and Compliance",
"description": "Returns Screening of Risk and Compliance",
"operationId": "searchRandC",
"parameters": [
{
"$ref": "#/components/parameters/control_data"
},
{
"$ref": "#/components/parameters/djip-UserCredentialData"
},
{
"$ref": "#/components/parameters/djip-SessionID"
},
{
"$ref": "#/components/parameters/djip-AuthorizationData"
}
],
"requestBody": {
"content": {
"application/vnd.dowjones.dna.riskentities.v_2.0+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV2"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExample"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExample"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExample"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExample"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.1+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV2"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExample"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExample"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExample"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExample"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.2+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV22"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExampleV22"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExampleV22"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExampleV22"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExampleV22"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.3+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV23"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExampleV23"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExampleV23"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExampleV23"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExampleV23"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.4+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV24"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExampleV24"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExampleV24"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExampleV24"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExampleV24"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.5+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV25"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExampleV25"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExampleV25"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExampleV25"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExampleV25"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
},
"application/vnd.dowjones.dna.riskentities.v_2.6+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningRequestV26"
},
"examples": {
"NameSearchWithAuditExample": {
"$ref": "#/components/examples/NameSearchWithAuditExampleV26"
},
"NameSearchExample": {
"$ref": "#/components/examples/NameSearchExampleV26"
},
"PersonNameExample": {
"$ref": "#/components/examples/PersonNameExampleV26"
},
"EntityNameExample": {
"$ref": "#/components/examples/EntityNameExampleV26"
},
"IDTypeSearchExample": {
"$ref": "#/components/examples/IDTypeSearchExample"
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "Ok",
"content": {
"application/vnd.dowjones.dna.riskentities.v_2.6+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV26"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.5+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV25"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.4+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV24"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.3+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV23"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.2+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV2"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.1+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV2"
}
},
"application/vnd.dowjones.dna.riskentities.v_2.0+json": {
"schema": {
"$ref": "#/components/schemas/ScreeningResponseV20"
}
}
}
},
"400": {
"description": "Bad request"
}
}
}
}
},
"components": {
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"name": "Authorization",
"in": "header"
}
},
"parameters": {
"control_data": {
"name": "control_data",
"in": "header",
"required": false,
"schema": {
"type": "string"
}
},
"djip-UserCredentialData": {
"name": "djip-UserCredentialData",
"description": "Credential information for the transaction",
"in": "header",
"required": false,
"schema": {
"type": "string",
"default": "{\"userId\":\"EnterUserId\",\"accountId\":\"EnterAccountID\",\"userPassword\":\"EnterPassword\",\"namespace\":\"EnterNameSpace\"}"
}
},
"djip-SessionID": {
"name": "djip-SessionID",
"description": "Session ID for the transaction",
"in": "header",
"required": false,
"schema": {
"type": "string"
}
},
"djip-AuthorizationData": {
"name": "djip-AuthorizationData",
"description": "Authorization Data for the transaction",
"in": "header",
"required": false,
"schema": {
"type": "string"
}
},
"accept-language": {
"name": "accept-language",
"in": "header",
"required": false,
"schema": {
"type": "string"
}
}
},
"schemas": {
"ScreeningRequestV2": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV2"
}
}
},
"ScreeningRequestV22": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV22"
}
}
},
"ScreeningRequestV23": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV23"
}
}
},
"ScreeningRequestV24": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV24"
}
}
},
"ScreeningRequestV25": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV25"
}
}
},
"ScreeningRequestV26": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/DataV26"
}
}
},
"DataV2": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV2"
}
}
},
"DataV22": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV22"
}
}
},
"DataV23": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV23"
}
}
},
"DataV24": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV24"
}
}
},
"DataV25": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV25"
}
}
},
"DataV26": {
"type": "object",
"properties": {
"attributes": {
"$ref": "#/components/schemas/RequestAttributesV26"
}
}
},
"RequestAttributesV2": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAnd"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOr"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"RequestAttributesV22": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAndV22"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOrV22"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"RequestAttributesV23": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAndV22"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOrV22"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
},
"is_private_lists": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"RequestAttributesV24": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAndV24"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOrV24"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
},
"is_private_lists": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"RequestAttributesV25": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAndV25"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOrV25"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
},
"is_private_lists": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"RequestAttributesV26": {
"type": "object",
"properties": {
"filter_group_and": {
"$ref": "#/components/schemas/FilterGroupAndV26"
},
"filter_group_or": {
"$ref": "#/components/schemas/FilterGroupOrV26"
},
"paging": {
"$ref": "#/components/schemas/Paging"
},
"screening_context": {
"type": "string",
"example": ""
},
"sort": {
"$ref": "#/components/schemas/SortOptions"
},
"is_audit": {
"type": "boolean"
},
"is_private_lists": {
"type": "boolean"
}
},
"description": "Request's Attributes class"
},
"FilterGroupAnd": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"AND"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersV2"
}
}
},
"FilterGroupAndV22": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"AND"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersV22"
}
}
},
"FiltersV2": {
"type": "object",
"properties": {
"search_keyword": {
"$ref": "#/components/schemas/SearchKeyword"
},
"country_territory": {
"$ref": "#/components/schemas/CountryRequestV1"
},
"identification": {
"$ref": "#/components/schemas/Identification"
},
"entity_name": {
"$ref": "#/components/schemas/EntityName"
},
"date_of_birth": {
"$ref": "#/components/schemas/DateOfBirth"
},
"person_name": {
"$ref": "#/components/schemas/PersonName"
},
"record_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Person",
"Entity"
]
}
},
"content_set": {
"type": "array",
"example": [
"Watchlist",
"Locations",
"StateOwnedCompanies",
"AntiCorruption",
"AdverseMedia"
],
"items": {
"type": "string",
"enum": [
"Watchlist",
"AdverseMedia",
"StateOwnedCompanies",
"AntiCorruption",
"HighRiskFactors",
"Locations",
"TradeCompliance"
]
}
}
}
},
"FiltersV22": {
"type": "object",
"properties": {
"search_keyword": {
"$ref": "#/components/schemas/SearchKeyword"
},
"country_territory": {
"$ref": "#/components/schemas/CountryRequestV1"
},
"identification": {
"$ref": "#/components/schemas/Identification"
},
"entity_name": {
"$ref": "#/components/schemas/EntityName"
},
"date_of_birth": {
"$ref": "#/components/schemas/DateOfBirth"
},
"person_name": {
"$ref": "#/components/schemas/PersonName"
},
"record_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Person",
"Entity"
]
}
},
"content_set": {
"type": "array",
"example": [
"Watchlist",
"Locations",
"StateOwnedCompanies",
"AntiCorruption",
"AdverseMedia"
],
"items": {
"type": "string",
"enum": [
"Watchlist",
"AdverseMedia",
"StateOwnedCompanies",
"AntiCorruption",
"HighRiskFactors",
"Locations",
"TradeCompliance"
]
}
},
"gender": {
"type": "array",
"example": [
"male",
"female"
],
"items": {
"type": "string",
"enum": [
"male",
"female",
"unknown"
]
}
}
}
},
"FiltersV24": {
"type": "object",
"properties": {
"search_keyword": {
"$ref": "#/components/schemas/SearchKeywordV2"
},
"country_territory": {
"$ref": "#/components/schemas/CountryRequestV24"
},
"identification": {
"$ref": "#/components/schemas/Identification"
},
"entity_name": {
"$ref": "#/components/schemas/EntityName"
},
"date_of_birth": {
"$ref": "#/components/schemas/DateOfBirth"
},
"person_name": {
"$ref": "#/components/schemas/PersonName"
},
"record_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Person",
"Entity"
]
}
},
"content_set": {
"type": "array",
"example": [
"Watchlist",
"Locations",
"StateOwnedCompanies",
"AntiCorruption",
"AdverseMedia"
],
"items": {
"type": "string",
"enum": [
"Watchlist",
"AdverseMedia",
"StateOwnedCompanies",
"AntiCorruption",
"HighRiskFactors",
"Locations",
"TradeCompliance"
]
}
}
}
},
"FiltersV25": {
"type": "object",
"properties": {
"search_keyword": {
"$ref": "#/components/schemas/SearchKeyword"
},
"country_territory": {
"$ref": "#/components/schemas/CountryRequestV24"
},
"identification": {
"$ref": "#/components/schemas/Identification"
},
"entity_name": {
"$ref": "#/components/schemas/EntityName"
},
"date_of_birth": {
"$ref": "#/components/schemas/DateOfBirth"
},
"person_name": {
"$ref": "#/components/schemas/PersonName"
},
"last_review_date": {
"$ref": "#/components/schemas/LastReviewDate"
},
"record_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Person",
"Entity"
]
}
},
"content_set": {
"type": "array",
"example": [
"Watchlist",
"Locations",
"StateOwnedCompanies",
"AntiCorruption",
"AdverseMedia"
],
"items": {
"type": "string",
"enum": [
"Watchlist",
"AdverseMedia",
"StateOwnedCompanies",
"AntiCorruption",
"HighRiskFactors",
"Locations",
"TradeCompliance"
]
}
}
}
},
"FiltersV26": {
"type": "object",
"properties": {
"search_keyword": {
"$ref": "#/components/schemas/SearchKeyword"
},
"country_territory": {
"$ref": "#/components/schemas/CountryRequestV26"
},
"identification": {
"$ref": "#/components/schemas/Identification"
},
"entity_name": {
"$ref": "#/components/schemas/EntityName"
},
"date_of_birth": {
"$ref": "#/components/schemas/DateOfBirth"
},
"person_name": {
"$ref": "#/components/schemas/PersonName"
},
"last_review_date": {
"$ref": "#/components/schemas/LastReviewDateV26"
},
"record_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Person",
"Entity"
]
}
},
"content_set": {
"type": "array",
"example": [
"Watchlist",
"Locations",
"StateOwnedCompanies",
"AntiCorruption",
"TradeRestrictedAssociatedEntity"
],
"items": {
"type": "string",
"enum": [
"Watchlist",
"AdverseMedia",
"StateOwnedCompanies",
"AntiCorruption",
"HighRiskFactors",
"Locations",
"TradeCompliance",
"MilitaryEndUse",
"TradeRestrictedAssociatedEntity"
]
}
}
}
},
"FilterGroupAndV24": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"AND"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersV24"
}
}
},
"FilterGroupAndV25": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"AND"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersV25"
}
}
},
"FilterGroupAndV26": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"AND"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersV26"
}
}
},
"CountryRequestV1": {
"type": "object",
"properties": {
"country_territory_types": {
"$ref": "#/components/schemas/CountryTerritoryTypes"
},
"countries_territories": {
"$ref": "#/components/schemas/Countries"
}
}
},
"CountryRequestV24": {
"type": "object",
"properties": {
"country_territory_types": {
"$ref": "#/components/schemas/CountryTerritoryTypesV2"
},
"countries_territories": {
"$ref": "#/components/schemas/CountriesV24"
}
}
},
"CountryRequestV26": {
"type": "object",
"properties": {
"country_territory_types": {
"$ref": "#/components/schemas/CountryTerritoryTypesV26"
},
"countries_territories": {
"$ref": "#/components/schemas/CountryTerritoryV26"
}
}
},
"FilterGroupOr": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"OR"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersLists"
}
}
},
"FilterGroupOrV22": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"OR"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersListsV22"
}
}
},
"FilterGroupOrV24": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"OR"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersListsV24"
}
}
},
"FilterGroupOrV25": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"OR"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersListsV25"
}
}
},
"FilterGroupOrV26": {
"type": "object",
"properties": {
"group_operator": {
"type": "string",
"enum": [
"OR"
]
},
"filters": {
"$ref": "#/components/schemas/FiltersListsV26"
}
}
},
"Paging": {
"type": "object",
"properties": {
"offset": {
"type": "integer",
"format": "int32"
},
"limit": {
"type": "integer",
"format": "int32",
"example": 10
}
}
},
"FiltersLists": {
"type": "object",
"properties": {
"sanctions_list": {
"$ref": "#/components/schemas/SanctionsList"
},
"content_category": {
"$ref": "#/components/schemas/ContentCategory"
},
"other_official_list": {
"$ref": "#/components/schemas/OtherOfficialList"
},
"other_exclusion_list": {
"$ref": "#/components/schemas/OtherExclusionList"
},
"state_ownership": {
"$ref": "#/components/schemas/StateOwnership"
},
"occupation_category": {
"$ref": "#/components/schemas/OccupationCategory"
},
"hrf_category": {
"$ref": "#/components/schemas/HrfCategory"
}
}
},
"FiltersListsV22": {
"type": "object",
"properties": {
"sanctions_list": {
"$ref": "#/components/schemas/SanctionsListV22"
},
"content_category": {
"$ref": "#/components/schemas/ContentCategoryV22"
},
"other_official_list": {
"$ref": "#/components/schemas/OtherOfficialListV22"
},
"other_exclusion_list": {
"$ref": "#/components/schemas/OtherExclusionListV22"
},
"state_ownership": {
"$ref": "#/components/schemas/StateOwnershipV22"
},
"occupation_category": {
"$ref": "#/components/schemas/OccupationCategoryV22"
},
"hrf_category": {
"$ref": "#/components/schemas/HrfCategoryV22"
}
}
},
"FiltersListsV24": {
"type": "object",
"properties": {
"sanctions_list": {
"$ref": "#/components/schemas/SanctionsListV24"
},
"content_category": {
"$ref": "#/components/schemas/ContentCategoryV24"
},
"other_official_list": {
"$ref": "#/components/schemas/OtherOfficialListV24"
},
"other_exclusion_list": {
"$ref": "#/components/schemas/OtherExclusionListV24"
},
"state_ownership": {
"$ref": "#/components/schemas/StateOwnershipV22"
},
"occupation_category": {
"$ref": "#/components/schemas/OccupationCategoryV24"
},
"hrf_category": {
"$ref": "#/components/schemas/HrfCategoryV24"
}
}
},
"FiltersListsV25": {
"type": "object",
"properties": {
"sanctions_list": {
"$ref": "#/components/schemas/SanctionsListV25"
},
# --- truncated at 32 KB (239 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dow-jones/refs/heads/main/openapi/dow-jones-risk-search-api-openapi.json