Dow Jones Risk Profiles API
Retrieve full Risk & Compliance profiles, analyst notes, images, and connection graphs by profile ID.
OpenAPI Specification
{
"openapi": "3.0.1",
"info": {
"title": "Dow Jones R&C Profile API",
"description": "R&C Profile API delivers the capability for clients to retrieve the R&C Assets.",
"version": "1.5"
},
"servers": [
{
"url": "https://api.dowjones.com/riskentities"
},
{
"url": "https://eu.api.dowjones.com/riskentities"
}
],
"tags": [
{
"name": "Profiles",
"description": "Operations to retrieve R&C Profiles"
},
{
"name": "Images",
"description": "Operations to retrieve R&C Images"
},
{
"name": "Connection Details",
"description": "Operations to retrieve the Connection Details of a R&C Profile"
}
],
"paths": {
"/profiles/{id}": {
"get": {
"security": [
{
"bearerAuth": []
}
],
"tags": [
"Profiles"
],
"summary": "Get Profiles",
"description": "Get R&C profile given an profile id. It is possible to get only parts of the profile, to reduce response size, using the parts parameter.",
"operationId": "getProfiles",
"parameters": [
{
"$ref": "#/components/parameters/Id"
},
{
"$ref": "#/components/parameters/ProfileParts"
},
{
"$ref": "#/components/parameters/ProfilesListsDescription"
},
{
"$ref": "#/components/parameters/IsAudit"
},
{
"$ref": "#/components/parameters/AcceptLanguage"
},
{
"$ref": "#/components/parameters/ProfileNotesTargetTranslation"
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponse"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_1.0+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponse"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.0+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV20"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.1+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV21"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.2+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV22"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.3+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV23"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.4+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV24"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.5+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV25"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.6+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV26"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.7+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV27"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_2.8+json": {
"schema": {
"$ref": "#/components/schemas/ProfileResponseV28"
}
}
}
},
"404": {
"description": "Not found"
}
}
}
},
"/profiles/{id}/profile-notes": {
"get": {
"tags": [
"Profiles"
],
"summary": "Get Profile Notes by Profile id",
"description": "Get profile notes from a profile given its id.",
"operationId": "getProfileNotes",
"parameters": [
{
"$ref": "#/components/parameters/Id"
},
{
"$ref": "#/components/parameters/ProfileNotesParts"
},
{
"$ref": "#/components/parameters/TargetLanguage"
}
],
"responses": {
"200": {
"description": "successful operation",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProfileNotesResponseV2"
}
},
"application/vnd.dowjones.dna.riskentities-profiles.v_1.0+json": {
"schema": {
"$ref": "#/components/schemas/ProfileNotesResponseV2"
}
}
}
},
"404": {
"description": "Not found"
}
}
}
},
"/images/{id}": {
"get": {
"security": [
{
"bearerAuth": []
}
],
"tags": [
"Images"
],
"summary": "Get Image by Image Reference",
"description": "Get an image given an image reference id. Can only retrieve one image at a time",
"operationId": "getOneImage",
"parameters": [
{
"$ref": "#/components/parameters/Id"
}
],
"responses": {
"200": {
"description": "successful operation",
"headers": {
"X-Content-Type-Options": {
"description": "nosniff",
"schema": {
"type": "string"
}
},
"X-XSS-Protection": {
"description": "1; mode=block",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ImageResponse"
}
},
"application/vnd.dowjones.dna.riskentities-images.v_1.0+json": {
"schema": {
"$ref": "#/components/schemas/ImageResponse"
}
}
}
}
}
}
},
"/profiles/{id}/connection-details": {
"get": {
"security": [
{
"bearerAuth": []
}
],
"tags": [
"Connection Details"
],
"summary": "Get the connection details for a profile",
"description": "Get a list of connectionDetails for a given profile ID. It is possible to filter through name, type, connection and icon. It is also possible to get the results ordered and with pagination.",
"operationId": "getRelationshipsFromProfile",
"parameters": [
{
"$ref": "#/components/parameters/Id"
},
{
"$ref": "#/components/parameters/FilterProfileType"
},
{
"$ref": "#/components/parameters/FilterProfileTypeCode"
},
{
"$ref": "#/components/parameters/FilterConnectionType"
},
{
"$ref": "#/components/parameters/FilterConnectionTypeCode"
},
{
"$ref": "#/components/parameters/FilterFullName"
},
{
"$ref": "#/components/parameters/FilterIconHint"
},
{
"$ref": "#/components/parameters/Sort"
},
{
"$ref": "#/components/parameters/PageOffset"
},
{
"$ref": "#/components/parameters/PageLimit"
},
{
"$ref": "#/components/parameters/AcceptLanguage"
}
],
"responses": {
"200": {
"description": "succesful operation",
"content": {
"application/vnd.dowjones.dna.riskentities-connection-details.v_1.0+json": {
"schema": {
"$ref": "#/components/schemas/ResponseConnectionDetails"
}
},
"application/vnd.dowjones.dna.riskentities-connection-details.v_1.1+json": {
"schema": {
"$ref": "#/components/schemas/ResponseConnectionDetailsV11"
}
},
"application/vnd.dowjones.dna.riskentities-connection-details.v_1.2+json": {
"schema": {
"$ref": "#/components/schemas/ResponseConnectionDetailsV12"
}
}
}
},
"404": {
"description": "Not found"
},
"406": {
"description": "Not Acceptable - application/json is not supported for this endpoint"
}
}
}
}
},
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
},
"schemas": {
"ProfileResponse": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributes"
},
"meta": {
"$ref": "#/components/schemas/Meta"
}
}
}
}
},
"ProfileResponseV20": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV20"
},
"meta": {
"$ref": "#/components/schemas/Meta"
}
}
}
}
},
"ProfileResponseV21": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV21"
},
"meta": {
"$ref": "#/components/schemas/Meta"
}
}
}
}
},
"ProfileResponseV22": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV22"
},
"meta": {
"$ref": "#/components/schemas/Meta"
}
}
}
}
},
"ProfileResponseV23": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV22"
}
}
},
"meta": {
"$ref": "#/components/schemas/MetaAudit"
}
}
},
"ProfileResponseV24": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV24"
}
}
},
"links": {
"$ref": "#/components/schemas/Links"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
}
},
"ProfileResponseV25": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV25"
}
}
},
"links": {
"$ref": "#/components/schemas/Links"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
}
},
"ProfileResponseV26": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV26"
}
}
},
"links": {
"$ref": "#/components/schemas/Links"
},
"meta": {
"$ref": "#/components/schemas/ResponseMeta"
}
}
},
"ProfileResponseV27": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV27"
}
}
},
"links": {
"$ref": "#/components/schemas/Links"
},
"meta": {
"$ref": "#/components/schemas/ResponseMetaV27"
}
}
},
"ProfileResponseV28": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profiles"
},
"attributes": {
"$ref": "#/components/schemas/ProfileAttributesV28"
}
}
},
"links": {
"$ref": "#/components/schemas/Links"
},
"meta": {
"$ref": "#/components/schemas/ResponseMetaV28"
}
}
},
"ProfileNotesResponseV2": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "12300"
},
"type": {
"type": "string",
"example": "profile-notes"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"attributes": {
"$ref": "#/components/schemas/ProfileNotesAttributes"
}
}
}
}
},
"ProfileNotesAttributes": {
"type": "object",
"properties": {
"state_owned_company": {
"$ref": "#/components/schemas/ProfileNotesDetails"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/ProfileNotesDetails"
},
"watchlist": {
"$ref": "#/components/schemas/ProfileNotesDetails"
},
"high_risk_factor": {
"$ref": "#/components/schemas/ProfileNotesDetails"
}
}
},
"ProfileNotesDetails": {
"type": "object",
"properties": {
"comment_details": {
"$ref": "#/components/schemas/CommentDetailsV26"
}
}
},
"ProfileAttributes": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributes"
},
"person": {
"$ref": "#/components/schemas/PersonAttributes"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributes"
},
"location": {
"$ref": "#/components/schemas/LocationAttributes"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributes"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributes"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributes"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributes"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributes"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributes"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV20": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributes"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV20"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV20"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV20"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributes"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV21": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV21"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV20"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV20"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV20"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributes"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV22": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV21"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV22"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV20"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV20"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV24": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV21"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV22"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV20"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV24"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV25": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV21"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV22"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV25"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV24"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
}
}
},
"ProfileAttributesV26": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV21"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV20"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV22"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV20"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV20"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV20"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV25"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV20"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV24"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
},
"military_associated_entity": {
"$ref": "#/components/schemas/MilitaryAssociatedEntityAttributesV26"
}
}
},
"ProfileAttributesV27": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV27"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV27"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV27"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV27"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV27"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV27"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV27"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV27"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV27"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
},
"military_associated_entity": {
"$ref": "#/components/schemas/MilitaryAssociatedEntityAttributesV27"
}
}
},
"ProfileAttributesV28": {
"type": "object",
"properties": {
"basic": {
"$ref": "#/components/schemas/BasicAttributesV27"
},
"person": {
"$ref": "#/components/schemas/PersonAttributesV27"
},
"entity": {
"$ref": "#/components/schemas/EntityAttributesV27"
},
"location": {
"$ref": "#/components/schemas/LocationAttributesV27"
},
"state_owned_companies": {
"$ref": "#/components/schemas/StateOwnedCompanyAttributesV27"
},
"adverse_media_entity": {
"$ref": "#/components/schemas/AdverseMediaAttributesV27"
},
"watchlist": {
"$ref": "#/components/schemas/WatchlistAttributesV27"
},
"high_risk_factor": {
"$ref": "#/components/schemas/HighRiskFactorAttributesV27"
},
"relationship": {
"$ref": "#/components/schemas/ConnectionAttributesV27"
},
"list_reference": {
"$ref": "#/components/schemas/ListReferenceAttributesV22"
},
"image": {
"$ref": "#/components/schemas/ImageAttributes"
},
"military_associated_entity": {
"$ref": "#/components/schemas/MilitaryAssociatedEntityAttributesV27"
},
"trade_restricted_associated_entity": {
"$ref": "#/components/schemas/TradeRestrictedAssociatedEntityAttributesV28"
}
}
},
"ImageResponse": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"attributes": {
"type": "object",
"properties": {
"image_bytes": {
"type": "string"
},
"image_type": {
"type": "string",
"example": "image/jpg"
},
"commerce_letter": {
"type": "object",
"properties": {
"accession_number": {
"type": "string"
},
"function_code": {
"type": "string"
},
"publication_code": {
"type": "string"
},
"response_id": {
"type": "string"
},
"status_indicator": {
"type": "string"
}
}
}
}
},
"type": {
"type": "string",
"example": "images"
},
"links": {
"$ref": "#/components/schemas/Links"
},
"id": {
"type": "string",
"example": "12300"
}
}
},
"meta": {
"$ref": "#/components/schemas/MetaCount"
}
}
},
"BasicAttributes": {
"type": "object",
"properties": {
"asset_type": {
"type": "string"
},
"last_reviewed_date": {
"type": "string",
"format": "date-time"
},
"content_notice": {
"type": "string"
},
"type": {
"type": "string"
},
"factiva_code": {
"type": "string"
},
"name_details": {
"$ref": "#/components/schemas/NameDetails"
},
"location_name_details": {
"$ref": "#/components/schemas/NameDetails"
},
"address_details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/AddressDetail"
}
}
}
},
"BasicAttributesV21": {
"type": "object",
"properties": {
"asset_type": {
"type": "string"
},
"last_reviewed_date": {
"type": "string",
# --- truncated at 32 KB (132 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dow-jones/refs/heads/main/openapi/dow-jones-risk-profiles-api-openapi.json