Data Features

This section covers the multiple data features or areas within a World-Check On Demand record. Each record has two top-level objects:

Record
Record Meta

Record

The record object contains details regarding the record subject.

Unique Identifier (UID)

World-Check On Demand’s API response can contain one or more records depending on the query used. Each record is unique distinguished by a uid and records are de-duplicated to achieve efficiencies in screening results.

"uid": 12345, <-------------
"recordType": {
    "id": "d5b8abd62828292bf5d6eda9fa0684a0",
    "value": "wcRecordType:IND"

`uid`

The unique identifier for each World-Check record within World-Check On Demand and related products (e.g., World-Check Data File, World-Check One).

Language

Records use a default language for all data elements, unless specified. The default language is UK English.

"language": "en-GB", <-------------
"recordStatus": {
                "id": "08d0f3f74ba789c3315d8d888194016c",
                "value": "wcRecordStatus:ACTIVE",
                "valueDataType": "wcDataType:Q_CODE"

`language`

Indicates the default language for all data elements within the record. Elements in alternative languages are indicated accordingly.

Record Types & Record Sub-Types

To allow clear identification of records, each World-Check On Demand record is classified into one of seven record types. Each record type can have none or many sub-types that provide additional granular insight into the nature of the record subject.

"recordType": {
    "id": "d5b8abd62828292bf5d6eda9fa0684a0",
    "recordSubTypes": [
        {
            "id": "64c7399e9895734a7afc46cb71a2121b",
            "isDefault": true,
            "value": "wcRecordSubType:DIPLOMAT" <-------------
        },
        {
            "id": "64c7399e9895734a7afc46cb71a2121b",
            "isDefault": true,
            "value": "wcRecordSubType:MILITARY" <-------------
        }
    ],
    "value": "wcRecordType:IND" <-------------

`recordType`

The object containing the details related to the record type and record sub-type.

`recordSubTypes`

The object containing the details related to the record type and record sub-type.

`id`

Identifier for key properties so that changes to their values can be tracked within the Change History.

Mapping of Record Types and Record Sub-Types:

Record Types	Record Sub-Types
ENTITY	Bank
	Corporate
	Political Party
	Trade Union
	Shell Bank or Company
	Organisation
GEOGRAPHY	Embargoed Country
	Risk Country
	Special Jurisdiction
	Address
INDIVIDUAL	Legal
	Military
	Diplomat
	Political Individual
	Religion
	Individual
	Post Conviction
AIRCRAFT	Embargo Aircraft
	Sanctions/Embargo Related Aircraft
	Special Interest Aircraft
VESSEL	Embargo Vessel
	Sanctions/Embargo Related Vessel
	Special Interest Vessel
	Vessel in Iran Economic Indicator List
PORT	Seaport
	Airport
WEBSITE

Record Status

The record status indicates whether a record is Active or Deleted. The reason is also included when a record is of the Deleted state.

Record status object of an active record.
"recordStatus": {
    "id": "08d0f3f74ba789c3315d8d888194016c",
    "value": "wcRecordStatus:ACTIVE", <-------------
    "valueDataType": "wcDataType:Q_CODE"
},

Record status object of a deleted record.
"recordStatus": {
    "details": [
        {
            "role": "wcRecordStatusRole:STATUS_REASON",
            "value": "wcRecordStatusReason:DUP_REC",
            "valueDataType": "wcDataType:Q_CODE"
        }
    ],
    "id": "a303760c9413d26118803d9cd595d824",
    "value": "wcRecordStatus:DELETED", <-------------
    "valueDataType": "wcDataType:Q_CODE"
},

`details`

When present, this array contains one or more related information about the status.

`details.value`

Contains a concept within the record status reason scheme (scheme ID = wcRecordStatusReason) which indicates whether a record was deleted due to it being a duplicate or because it has fallen out of the World-Check inclusion criteria.

Keyword Reference List

World-Check indicates the provenance or official sources of one or more data elements in a record by assigning keywords to records. The keyword entries in this area are referenced by keyword identifiers at the data element / field level, when available. Keywords are specific sources (concepts) within the Source Keywords scheme (scheme ID = wcSourceKwd).

Types of sources that are associated with one or more keywords:

Keyword Type
Explicit Sanctions
Implicit Sanctions
Sanctions Related
Law Enforcement
Regulatory Enforcement
World-Check Data
Investigative Journalism
Government PEP List
NGO

Credible media sources remain a critical source of information that are used extensively by World-Check Research; however, these sources are not associated with keywords. Therefore, not all World-Check records contain keywords.

The Keyword Reference List provides a list of any keywords that have been assigned to a World-Check On Demand record, thereby allowing clients to filter on and only screen against data from specific sources that are relevant to their needs. The Keyword Reference List also indicates whether the record subject is currently or formerly listed by an authority, or currently or formerly subject to implicit sanctions. The Effective From/To or Current From/To dates are also provided for each listing duration.

In the case of Sanctions listings, the statuses Current or Former are used as applicable. For Regulatory and Law Enforcement listings, only the Current status and date the subject was listed from will apply, since upon de-listing the related data is removed. The Keyword Reference List also provides unique keyword IDs that are used to indicate what specific data elements on the record originate from each keyworded source. This concept is known as “keyword tagging” and is indicated in each data feature below where this applies.

Keyword tagging is a powerful feature that allows clients to filter data elements that are associated with specific keywords from their local copy of the World-Check On Demand data. This feature is designed to dramatically reduce over screening and false positive alerts.

The Keyword Reference List array showing two keywords, each encapsulated within a keywordTag object. One of the keywords is Current while the other is a Former keyword.
"keywordReferenceList": [
    {
        "keywordTag": {
            "currentFrom": "2025-08-21T11:25:17.307Z",
            "id": "ef78636d1d2eb99b486858ec89ac0649",
            "keyword": "wcSourceKwd:OFAC", <-------------
            "status": {
                "value": "wcStatus:CURRENT",
                "valueDataType": "wcDataType:Q_CODE"
            }
        }
    },
    {
        "keywordTag": {
            "currentFrom": "2025-08-21T11:25:17.307Z",
            "id": "f4d0d31cf4a4eefcebb06ab637f5fa41",
            "keyword": "wcSourceKwd:UKHMT", <-------------
            "status": {
                "value": "wcStatus:FORMER",
                "valueDataType": "wcDataType:Q_CODE"
            }
        }
    }
],

`id`

The unique identifier for the keyword. This is used in (a) tracking changes in Change History, and (b) as reference for granular provenance at the data element level (keyword-tagging). The value of “id” is unique within a record.

`keyword`

The keyword/s assigned by World-Check to indicate the Official source that a record subject is/was listed on, and/or the source or provenance of the information used for that record. This qualified code is in the “wcSourceKwd” scheme.

`currentFrom`

When not provided by the source, these are dates on which World-Check applied a keyword to a record.

`currentTo`

When not provided by the source, these are dates on which World-Check recognise the removal of the record subject from the keyword. This is only present on sanctions keywords. Other than sanctions keyword types, all other keywords are removed from the record when the record subject is no longer designated. From this date, the keyword status is set to former, indicating that the record subject was formerly designated within the specified keyword.

`effectiveFrom`

The real-world effective date when a data subject was listed by a Sanctioning Authority or Official body.

`effectiveTo`

When available, this is the date that the subject was listed until by a Sanctioning Authority or Official body. This is only present on sanctions keywords. Other than sanctions keyword types, all other keywords are removed from the record when the record subject is no longer designated. Similar to “currentTo” the keyword status is set to former past this date, indicating that the record subject was formerly designated within the specified keyword.

`status.value`

Shows the current state of the record subject’s designation with respect to the specific keyword at the time of record publication.

Keyword Tagging

This feature extends the provenance from record-level (Keyword Reference List) to the level of key data elements. It allows the ability to filter or decide on these elements based on the sources associated with it. This is also known as field-level data provenance.

An example of keyword tagging, showing how the keyword references are associated with a record subject’s first and last names.
"nameInformation": {
    "nameDetails": [
        {
            "details": [
                {
                    "role": "wcNameRole:STRING_NAME",
                    "value": "Jardani JOVONOVICH",
                    "valueDataType": "wcDataType:STRING"
                },
                {
                    "role": "wcNameRole:FIRST_NAME",
                    "value": "Jardani",
                    "valueDataType": "wcDataType:STRING",
                    "relations": [
                        {
                            "rel":"wcRelatedRel:AS_REPORTED_BY_KEYWORD", <-------------
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                },
                {
                    "role": "wcNameRole:LAST_NAME",
                    "value": "KHAN",
                    "valueDataType": "wcDataType:STRING",
                    "relations": [
                        {
                            "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD", <-------------
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                }
            ],

`relations`

Array of related information that provides additional context or details for the key value within the object. Each related information is an element of this array.

`rel`

Provides context on what the element within the relations array is about. In the above example, the qualified code wcRelatedRel:AS_REPORTED_BY_KEYWORD indicates that it is a keyword tag.

`value`

This is the keyword reference ID for the specific keyword associated with the key value. This ID is used to look up the keyword details in the record’s Keyword Reference List. In the above example, the highlighted elements point to the OFAC keyword found in the table previous to it.

`valueDataType`

Keyword tags will always have a data type of wcDataType:IDREF, indicating that it is an intra-record ID reference.

Record Date Information

Provides the date/s on which a record was deleted, and where applicable, reactivated across the entire lifetime of the record. This feature provides complete transparency on the period/s during which a record may have been excluded from screening.

A Record Date Information object for a deleted record.
"recordDateInformation": {
    "recordDateDetails": [
        {
            "type": "wcRecordDateType:DELETION_DATE",
            "detail": {
                "role": "wcRecordDateRole:VALUE",
                "value": "2025-08-15T15:35:59.667Z",
                "valueDataType": "wcDataType:DATETIME"
            }
        }
    ]
},

A Record Date Information object for a reactivated record showing both deletion and reactivation events and the related timestamps
"recordDateInformation": {
    "recordDateDetails": [
        {
            "type": "wcRecordDateType:REACTIVATION_DATE",
            "detail": {
                "role": "wcRecordDateRole:VALUE",
                "value": "2025-08-15T15:35:59.667Z",
                "valueDataType": "wcDataType:DATETIME"
            }
        },
        {
            "type": "wcRecordDateType:DELETION_DATE",
            "detail": {
                "role": "wcRecordDateRole:VALUE",
                "value": "2023-01-31T00:26:15.889Z",
                "valueDataType": "wcDataType:DATETIME"
            }
        }
    ]
},

`type`

This provides the context on what the date is all about. Currently, there are only two possible values, (a) deletion date – the timestamp when the record’s status (in recordStatus) was set to deleted (“wcRecordStatus:DELETED”), and (b) reactivation date – the timestamp when the record was brought back to the active state (“wcRecordStatus:ACTIVE”).

`value`

The date and time associated with either deletion or reactivation.

Category Information

Category Information is a very powerful data feature that provides the ability for customers to easily segment, filter, and include only the records that are relevant and required for the screening use case at hand, based on customer-specific risk mitigation and regulatory compliance imperatives. The feature also delivers improved and more efficient decision making by providing a way to quickly and easily assess the nature of reported risk/s associated with a record subject.

Every World-Check On Demand record contains at least one Category set, provided by a categoryPath, with each set containing an overarching classification of the subject, at Level 1. Subsequent levels (2, 3, 4, etc.) provide increasing granularity of information regarding the categories relating to each record.

The Category Information is a quick way to evaluate why the record subject is included in World-Check.
"categoryInformation": {
    "categories": [
        {
            "categoryPath": "wcCat1:SANCTIONS_LISTED/wcCat2:EXP_SANC", <-------------
            "id": "a161b1f591625a344857f0f0cb3e563e"
        },
        {
            "categoryPath": "wcCat1:SPECIAL_INTEREST/wcCat2:OTHERCRIME/wcCat3:ILLCO", <-------------
            "id": "18ae6cf7bded3810366697c841fdd23e"
        },
        {
            "categoryPath": "wcCat1:POLITICALLY_EXPOSED/wcCat2:PEP_N", <-------------
            "id": "230e2010779ef7515e75cbe7877a188a"
        },
        {
            "categoryPath": "wcCat1:OTHER_OFFICIAL_LISTED/wcCat2:LAW_LSTD", <-------------
            "id": "0ed1a6daf8cee609cb8253390dbd954c"
        },

`categoryPath`

Represents a set of categories for a record, where the overarching category is represented as Category 1 with increasingly more granular category levels provided at Category 2, Category 3, etc. Every World-Check On Demand record contains at least one Category Set, with at least two levels within each set.

Name Information

World-Check On Demand provides a highly structured and de-duplicated set of record subject names to suit various screening use cases. Names are provided in string format and in the Latin or non-Latin scripts exactly as reported by each source. Where possible these string values are broken down into their constituent name components such as the First, Middle, and Last Name. Each name or name component is tagged back to the specific keywords that reported those values and is assigned one or more of the standard name types. This combination of features allows customers to exclude irrelevant names from specific sanctions sources for payments screening as well as for customer screening and other use cases.

The Name Information section, showing a single full name, its component parts and related keywords and attributes.
"nameInformation": {
    "nameDetails": [
        "isDefault": true,
        {
            "details": [
                {
                    "role": "wcNameRole:STRING_NAME",
                    "value": "Jardani JOVONOVICH",
                    "valueDataType": "wcDataType:STRING"
                },
                {
                    "role": "wcNameRole:FIRST_NAME",
                    "value": "Jardani",
                    "valueDataType": "wcDataType:STRING",
                    "relations": [
                        {
                            "rel":"wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                },
                {
                    "role": "wcNameRole:LAST_NAME",
                    "value": "KHAN",
                    "valueDataType": "wcDataType:STRING",
                    "relations": [
                        {
                            "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                }
            ],
            "relations": [
                {
                    "rel": "wcRelatedRel:IS_LATIN_NAME",
                    "value": "true",
                    "valueDataType": "wcDataType:BOOLEAN"
                },
                {
                    "rel": "wcRelatedRel:HAS_WC_NAME_TYPE",
                    "value": "wcNameType:PRIMARY",
                    "valueDataType": "wcDataType:Q_CODE",
                    "relations": [
                        {
                            "rel":"wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                }
            ]

`details.role`

Within each name entry, the role provides some context on what this part of the name is. In the example above, the name is a STRING_NAME, which means that it is a full name of the record subject as reported by the different source. Other potential values could be name components, when available, such as FIRST_NAME, MIDDLE_NAME, or LAST_NAME, or could be an alternative value such as CHINESE_COMMERCIAL_CODE.

`details.value`

This is the actual value of the name entry within the context of the role.

`relations`

This array holds the list of additional optional attributes related to the name role.

`relations.rel`

Provides context on what the attribute is about in relation to the parent object of relations. For example, if the parent object is nameDetails then the related attributes apply for the entire name, across all name roles in details, such as an indicator that the name is a primary name or alias (wcRelatedRel:HAS_WC_NAME_TYPE). However, if the parent object is details then the attributes apply only on that specific name role entry, such as the keyword tag associated with the role.

`relations.value`

The value for this key is within the context of the associated rel and is the key value for the object, such as the name type (wcNameType:PRIMARY) or the ID reference in the case of keyword tags.

`relations.valueDataType`

This also depends on the rel and provides additional context on the nature of the value.

World-Check On Demand names can have one or more of these name roles within a single name entry.

Concept ID	Concept Name
wcNameRole:FIRST_NAME	First Name
wcNameRole:LAST_NAME	Last Name
wcNameRole:STRING_NAME	Name As-Is From Source
wcNameRole:CHINESE_COMMERCIAL_CODE	Chinese Commercial Code
wcNameRole:SINGLE_TITLE	Single Title (structured list)
wcNameRole:SINGLE_TITLE_AS_IS	Single Title As-Is

A name entry in a non-Latin script.
"id": "b4642f35272d5a10b027bf5f30aa2b5d",
"isDefault": false,
"details": [
    {
        "role": "wcNameRole:STRING_NAME",
        "value": "Ярдані Яванавіч",
        "valueDataType": "wcDataType:STRING"
    }
],
"relations": [
    {
        "rel": "wcRelatedRel:IS_NON_LATIN_NAME",
        "value": "true",
        "valueDataType": "wcDataType:BOOLEAN"
    },
    {
        "rel": "wcRelatedRel:HAS_LANGUAGE",
        "value": "wcLanguage:BE_BY",
        "valueDataType": "wcDataType:Q_CODE"
    },
    {
        "rel": "wcRelatedRel:HAS_WC_NAME_TYPE",
        "value": "wcNameType:AKA",
        "valueDataType": "wcDataType:Q_CODE"
    }
]

`rel`

wcRelatedRel:HAS_LANGUAGE - Indicates that the related information is about the language or script that the name is written on.
wcRelatedRel:IS_NON_LATIN_NAME- Indicates that the name is non-Latin (specifically, it does not conform to the ISO 8859-15, also known as Latin-9).

`value`

Ярдані Яванавіч - This is one of the names of the record subject within the record.
wcLanguage:BE_BY - The language or script that the name is written on. In this example, the name is in Belarusian.
true - Shows that the name is in a non-Latin script.

Gender Information

Provides the gender value/s for individuals. When available, gender values are tagged with the keywords on which they appear. A status object with a value of wcStatus:FORMER will be present for a specific gender that is no longer current. All other gender entries with no explicit status are assumed to be current.

A gender entry showing the details and keyword tag.
"genderInformation": {
    "genderDetails": [
        {
            "id": "8e6ba369b9331c1060d12b4998f5ed4f",
            "details": [
                {
                    "role": "wcGenderRole:VALUE",
                    "value": "wcGenderDetail:MALE",
                    "valueDataType": "wcDataType:Q_CODE",
                    "relations": [
                        {
                            "rel":"wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "ef78636d1d2eb99b486858ec89ac0649",
                            "valueDataType": "wcDataType:IDREF"
                        }
                    ]
                }

`details.value`

Contains the key information for the gender element. The above example shows that the gender is MALE.

Location Information

World-Check On Demand provides structured data showing the location(s) where the record subject reportedly is, has been active, or otherwise associated with. For example, birth location, citizenship, PEP location, base of operations, or company headquarters. Location values are tagged with the keywords in which they appear.

The Location Information showing the country of citizenship and other related details.
"locationInformation": {
    "locationDetails": [
        {
            "id": "a74dc321e5970f10dfd69bd53bf31df9",
            "isDefault": true,
            "type": "wcLocationType:CITIZENSHIP_LOCATION",
            "effectiveFrom": "2020-09-13",
            "status": {
                "value": "wcStatus:CURRENT",
                "valueDataType": "wcDataType:Q_CODE"
            },
            "details": [
                {
                    "role": "wcLocationRole:COUNTRY",
                    "value": "wcCountry:US",
                    "valueDataType": "wcDataType:Q_CODE",
                    "relations": [
                        {
                            "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "c1c94e7d0aeebc8a7eaadcf751a0a94a",
                            "valueDataType": "wcDataType:IDREF"
                        },

`type`

Indicates the type of the location information, whether it is about the record subject’s citizenship, residence, place of birth, etc. Additional types will be supported in the future.

`effectiveFrom`

Shows the date when this location is valid according to the source.

`status.value`

The state of the location information, whether it is current, or a former location associated with the record subject.

`details.role`

The level of granularity of this location information. This could be a country, state, provide, city, or an undefined general location. More granular roles may be added in the future.

`details.value`

Contains the key information about the location. The value will be a qualified code within one of the location schemes as determined by the “role”, or a string.

The available location types. Additional types will be supported in the future.

Concept ID	Concept Name
wcLocationType:AFFILIATION_LOCATION	Location of Affiliation
wcLocationType:AGENCY_LOCATION	Location of Agency
wcLocationType:BIRTH_LOCATION	Location of Birth
wcLocationType:BRANCH_LOCATION	Location of Branch
wcLocationType:CITIZENSHIP_LOCATION	Location of Citizenship
wcLocationType:FINANCIAL_HQ_LOCATION	Location of Financial Headquarters
wcLocationType:HQ_LOCATION	Location of Headquarters
wcLocationType:ISSUER_LOCATION	Location of Identification Number Issuer
wcLocationType:OWNERSHIP_LOCATION	Location of Ownership
wcLocationType:REGISTRATION_LOCATION	Location of Registration
wcLocationType:COMMISSION_LOCATION	Location of Reported Allegation
wcLocationType:RESIDENTIAL_LOCATION	Location of Residence
wcLocationType:UNDETERMINED_LOCATION	Undetermined Location
wcLocationType:PEP_LOCATION	Location of PEP Jurisdiction
wcLocationType:PHYSICAL_LOCATION	Physical Location
wcLocationType:OPERATING_LOCATION	Operations Location
wcLocationType:FLAG_LOCATION	Location of Vessel Flag
wcLocationType:AIRLINE_LOCATION	Location of Airline/Operator

The different location roles representing different levels of granularity. More granular roles may be added in the future.

Concept ID	Concept Name
wcLocationRole:STRING_LOCATION	Location As-Is From Source
wcLocationRole:CITY	City
wcLocationRole:COUNTRY	Country
wcLocationRole:STATE_PROVINCE	State/Province
wcLocationRole:INTL_REGION	International Region

Date Information

Provides pertinent dates related to the record subject, as well as the date type for each value. Date values are tagged with the keywords on which they appeared. All dates are in Gregorian calendar format, unless otherwise indicated.

The Date Information showing the date and the context in relation to the record subject.
"dateInformation": {
    "dateDetails": [
        {
            "id": "5c3269edd071c61e37f63d9f515505c2",
            "isDefault": true,
            "type": "wcDateType:REPORTED_DOB",
            "details": [
                {
                    "role": "wcDateRole:VALUE",
                    "validatedFormat": true,
                    "value": "1971-10-04",
                    "valueDataType": "wcDataType:DATE",
                    "relations": [
                        {
                            "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                            "value": "c1c94e7d0aeebc8a7eaadcf751a0a94a",
                            "valueDataType": "wcDataType:IDREF"
                        },

`type`

Indicates the type of date information, such as date of birth, or calculated year of birth. Additional date types will be added in the future.

`details.value`

Contains the date value in one of the possible formats as indicated by the valueDataType.

`details.valueDataType`

Provide the format information of the date, whether it is a full date, year and month, or just the year.

Identification Information

Provides reported identification numbers as well as the type and issuer location for each. Where known, the Effective From / To dates and Status (Former) are provided for ID numbers. Identification values are tagged with keywords on which they appeared.

This example shows a Russian passport categorised as an Individual Identification Number (IDCAT_INDIV_ID).
"identificationInformation": {
    "identificationDetails": [
        {
            "type": "wcIdentificationType:PASSPORT",
            "details": [
                {
                    "role": "wcIdentificationRole:VALUE",
                    "value": "XX123456789",
                    "valueDataType": "wcDataType:STRING"
                },
                {
                    "role": "wcIdentificationRole:ISSUING_COUNTRY",
                    "value": "wcCountry:RU",
                    "valueDataType": "wcDataType:Q_CODE"
                }
            ],
            "id": "e3a6749062359afdf2b0e068e3e8a93e",
            "relations": [
                {
                    "rel": "skos:broader",
                    "value": "wcIdentificationCategoryType:IDCAT_INDIV_ID",
                    "valueDataType": "wcDataType:Q_CODE"
                }
            ]

`type`

Indicates the type of identification, such as passport and many other types across all countries.

`details.value`

Where the role is wcIdentificationRole:VALUE, this is the key information related to the type of identification, such as the passport number, license number, or company registration number as reported by a source.
Where the role is wcIdentificationRole:ISSUING_COUNTRY, this is the country that issued the related identification type.

`relations.value`

This shows the category of the identification type. In the above example, the passport is of the Individual Identification Number type.

PEP Role Information

Provides structured data for each PEP Role to allow customised filtering of PEPs based on each customer’s specific definition of expired PEPs.

An entry in the PEP Role Information showing a former Cabinet Minister position.
"pepRoleInformation": {
    "status": {
        "value": "wcStatus:ACTIVE",
        "valueDataType": "wcDataType:Q_CODE"
    },
    "pepRoleDetails": [
        {
            "id": "3321d09da597070b76c0d8ace4fcd794",
            "role": {
                "value": "wcPepRole:CAB_MINI",
                "valueDataType": "wcDataType:Q_CODE"
            },
            "level": {
                "value": "wcPEPRoleLevel:NATIONAL",
                "valueDataType": "wcDataType:Q_CODE"
            },
            "position": {
                "value": "wcPepPosition:MEMOE",
                "valueDataType": "wcDataType:Q_CODE"
            },
            "effectiveFrom": {
                "value": "2020-08",
                "status": {
                    "value": "wcStatus:REPORTED"
                },
            },
            "effectiveTo": {
                "value": "2025-06",
                "status": {
                    "value": "wcStatus:CONFIRMED"
                },
            },
            "status": {
                "value": "wcStatus:FORMER",
                "valueDataType": "wcDataType:Q_CODE"
            },
            "roleBiography": [
                {
                    "value": "Minister of Social Affairs of the Transitional Government",
                    "valueDataType": "wcDataType:STRING"
                }
            ],
            "locationInformation": {
                "locationDetails": [
                    {
                        "type": "wcLocationType:PEP_LOCATION",
                        "details": [
                            {
                                "role": "wcLocationRole:COUNTRY",
                                "status": {
                                    "value": "wcStatus:FORMER",
                                    "valueDataType": "wcDataType:Q_CODE"
                                },
                                "value": "wcCountry:GH",
                                "valueDataType": "wcDataType:Q_CODE"
                            }
                        ]

`role`

The social or political job/role held by the record subject.

`level`

The role’s sphere of impact within political or government structures.

`position`

The equivalent standard World-Check PEP position for this record subject.

`effectiveFrom`

The start date for the role, when known. The “status” object within also indicates whether this date is confirmed or reported.

`effectiveTo`

The end date for the role, when known. The “status” object within also indicates whether this date is confirmed or reported.

`status`

Shows whether the role is current, former, or when the status is unknown.

`roleBiography`

The exact job title, possibly accompanied by a brief description of the role’s nature.

`locationInformation`

This object contains information on the jurisdiction or country in which the PEP role is located.

Connection Information

Provides insight on other World-Check records that are connected to the record subject as well as the nature of those connections. On a go-forward basis, ownership information will also be provided where relevant. Where a connection is to an entity that does not exist in World-Check, the name of that individual or entity is shown as a string value. All connection values will be tagged back with keywords on which they appeared, when available.

Connection details showing two connections types.
"connectionInformation": {
    "connectionDetails": [
        {
            "type": "wcRecordType:IND",
            "id": "d5916bad19a06cdf818b5c93b6de848b",
            "value": "456789",
            "valueDataType": "wcDataType:UID",
            "relations": [
                {
                    "rel": "wcRelatedRel:HAS_CONNECTION_DIRECTION",
                    "value": "wcConnectionDirectionType:BI_DIR",
                    "valueDataType": "wcDataType:Q_CODE"
                }
            ]
        },
        {
            "type": "wcRecordType:ENT",
            "id": "d5916bad19a06cdf818b5c93b6de848b",
            "value": "The Continental",
            "valueDataType": "wcDataType:STRING"
        }
    ]
}

`type`

Shows the record type of the connected World-Check record or non-World-Check entity.

`relations.rel`

Shows the type of related information, giving context to the value. In this example, the information is about connection directionality.

`relations.value`

Provides the directionality of the connection, whether this is bidirectional or unidirectional. This is only present when the connection is with another World-Check record.

`value`

This holds the key detail about the connection, which may be a World-Check record UID, or a string in the case of a non-World-Check record connection.

`valueDataType`

Provides context about the value, whether it is a World-Check UID or a non-World-Check connection in the case of wcDataType:STRING.

Provides additional structured information regarding the record subject that may be relevant for screening or remediation purposes, including but not limited to any contact information (e.g., email, phone, fax), details on cryptocurrency wallets, the type of website concerned, certain financial instruments that have been issued by the data subject, and other similar information. All related information entries are tagged to the keywords on which they appeared.

Related information about the record subject showing four different types of information.
"relatedSubjectInformation": {
    "relatedSubjectDetails": [
      {
        "details": [
          {
            "id": "abf034c426bfd5192a2fb5e58a547867",
            "role": "wcRelatedSubjectRole:HAS_INSTRUMENT",
            "value": "TRYKLGS00028",
            "valueDataType": "wcDataType:STRING",
            "relations": [
              {
                "rel": "wcRelatedRel:HAS_SYMBOL_TYPE",
                "value": "wcFinancialInstrumentType:INT_ISIN",
                "valueDataType": "wcDataType:Q_CODE"
              }
            ]
          },
          {
            "role": "wcIdentificationRole:ISSUING_COUNTRY",
            "value": "wcCountry:INT",
            "valueDataType": "wcDataType:Q_CODE"
          }
        ]
      },
      {
        "details": [
          {
            "id": "1c7f7a74e45a5544c9f454b0296ef028",
            "role": "wcRelatedSubjectRole:HAS_CRYPTO_ADDRESS",
            "value": "0x1234567F79a50D2bd05481C8515C1eF518978654",
            "valueDataType": "wcDataType:STRING",
            "relations": [
              {
                "rel": "wcRelatedRel:HAS_CURRENCY",
                "value": "wcCryptoAddressType:INT_ETH",
                "valueDataType": "wcDataType:Q_CODE"
              },
              {
                "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                "value": "4dc4bb326a50db2c4c65309f1be292f2",
                "valueDataType": "wcDataType:IDREF"
              }
            ]
          },
          {
            "role": "wcIdentificationRole:ISSUING_COUNTRY",
            "value": "wcCountry:INT",
            "valueDataType": "wcDataType:Q_CODE"
          }
        ]
      },
      {
        "details": [
          {
            "id": "74a4eaa82833e36aace641a5eef4584a",
            "role": "wcRelatedSubjectRole:HAS_EMAIL",
            "value": "info@asdfalkjlajsdlkfjadsf.com",
            "valueDataType": "wcDataType:STRING",
            "relations": [
              {
                "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                "value": "9861c5705a2fbb4d4492fd29524e004d",
                "valueDataType": "wcDataType:IDREF"
              }
            ]
          }
        ]
      },
      {
        "details": [
          {
            "id": "e6405d5bd9c2f7983718483834094655",
            "role": "wcRelatedSubjectRole:HAS_WEBSITE",
            "value": "https://www.asdfalkjlajsdlkfjadsf.com",
            "valueDataType": "wcDataType:STRING"
          }
        ]
      }
    ]
  }

`details.role`

Provides context on the type of related information. It can be the primary information regarding a related information such a financial instrument or a website, or it can be additional attributes regarding the primary information, such as the issuing country.

`details.value`

Contains the actual value or identifier of the item. For example, it can be the cryptocurrency address or financial instrument code, the country where the instrument was issued, or the actual website or email address.

`details.relations`

Provides additional information about the nature of the value.

rel: Provides context on the type of additional attribute, such as indicating that it is currency information.
value: The actual value of the additional attribute.

Further Information

Provides separate fields for unstructured narrative summaries about the record subject.

A sample Further Information showing the different types of information within.
"furtherInformation": {
    "furtherDetails": [
        {
            "id": "da680e80-840e-419f-96a6-9bd4fb3c01ba",
            "details": [
                {
                    "role": "wcFurtherInformation:BIOGRAPHY",
                    "value": "Project ever check eye source whom. Any choice court enough structure. Old ten half different continue note. President prevent positive sit successful similar smile.",
                    "valueDataType": "wcDataType:STRING"
                }
            ]
        },
        {
            "id": "c92e4ed9-f925-40b0-89ee-afe8b8047b9e",
            "details": [
                {
                    "role": "wcFurtherInformation:IDENTIFICATION",
                    "value": "Local cultural part from. Night seat talk study example main understand. Both federal realize land either. Today my technology. Hour follow nice. Home third positive treatment.",
                    "valueDataType": "wcDataType:STRING"
                }
            ]
        },
        {
            "id": "b921b768-1498-487d-bc18-4bad4459aeaf",
            "details": [
                {
                    "role": "wcFurtherInformation:REPORTS",
                    "value": "Mar 2014 - Energy store third plant example feel lawyer health. I talk take dark enjoy both appear. As that provide easy. Despite attorney place born we who. Catch leader figure. Bring thus law kid.",
                    "valueDataType": "wcDataType:STRING"
                }
            ]
        },
        {
            "id": "616db939-1d58-461d-8148-804fc193565a",
            "details": [
                {
                    "role": "wcFurtherInformation:ADDITIONAL_CMMNTS",
                    "value": "Wrong live fall whom activity. Director about current give tonight morning bit system. Same color government take. Theory office front share. Nearly option church challenge science.",
                    "valueDataType": "wcDataType:STRING"
                }
            ]
        }
    ]
},

`details.role`

Provides context on the type of unstructured narrative summaries about the record subject.

`details.value`

The narrative summaries about the record subject.

Source Reference List

Provides a structured list of all public sources that were used in the compilation of a World-Check record, including the public URL itself, an indicator of whether it contains an image of the data subject, and when it was added. Cached copies of URLs contents will be made available in the future through a World-Check On Demand user interface.

A Source Reference List entry showing the URL and related details.
"sourceReferenceList": {
    "sourceRefs": [
        {
            "id": "1360baeafba9e5a6b8d6cac9f749a302",
            "type": "wcResourceType:SOURCE_DATA",
            "description": {
                "value": "CANADA - CANSEMHT - Special Economic Measures - Haiti"
            },
            "details": [
                {
                    "role": "wcResourceRole:HAS_IMAGE",
                    "value": "true",
                    "valueDataType": "wcDataType:BOOLEAN"
                },
                {
                    "role": "wcDateRole:URL_ADDITION_DATE",
                    "value": "2022-10-04T03:35:10Z",
                    "valueDataType": "wcDataType:DATETIME"
                }
            ],
            "role": "wcResourceRole:RESOURCE_REF",
            "value": "https://www.international.gc.ca/world-monde/international_relations-relations_internationales/sanctions/haiti.aspx?lang=eng",
            "valueDataType": "wcDataType:ANYURI",
            "relations": [
                {
                    "rel": "wcRelatedRel:AS_REPORTED_BY_KEYWORD",
                    "value": "354b7e61950916d38376f583b8eccb22",
                    "valueDataType": "wcDataType:IDREF"
                }
            ]
        },

`type`

The “SOURCE_DATA” is only one resource type currently for all Source Reference List entries.

`role`

The context of this data with respect to record subject. It could be a reference for a resource or a type of attachment or content, etc.

`value`

The actual value of the resource. In this case, the value is a URL, as shown by the “valueDataType”.

`valueDataType`

The type of data in the “value” field. In this case, it is a URL.

`description`

A short description of the source entry. This may not always be present for a source entry.

`details`

Provides additional information about the source with respect to the record subject. In the above example, it indicates that the source has an image of the record subject, and shows the date when the URL was added to this record.

Record Meta

This top-level object contains related attributes about the record, not the record subject. It has important timestamps, such as the first and last times the record was published and the history of changes.

The Record Meta object showing the different timestamps and history of changes.
"recordMeta": {
    "initialPublishedDate": "2006-10-01T00:00:00.000Z",
    "lastPublishedDate": "2025-08-29T10:01:01.342Z",
    "changeHistory": [
        {
            "publishedDate": "2025-08-15T12:33:02.593Z",
            "updateCategory": "wcUpdateCat:C4",
            "added": [
                {
                    "value": "wcChangeArea:FTHR_INFM",
                    "valueDataType": "wcDataType:Q_CODE",
                    "idRefs": [
                        "38e8a54b77d5a32fb10ffaf87f16b252"
                    ]
                },
            ],
            "updated": [
                {
                    "value": "wcChangeArea:SRC_REF_LST",
                    "valueDataType": "wcDataType:Q_CODE",
                    "idRefs": [
                        "8fb6ce35dfe2b5ab5d8481dc9dd4036f",
                        "9c86150ffaad12fbcff92726ada4d0a2",
                        "aca6ddce409a7bd12f1b448e0389394a"
                    ]
                }
            ],
            "removed": [
                {
                    "value": "wcChangeArea:FTHR_INFM",
                    "valueDataType": "wcDataType:Q_CODE"
                }
            ]
        },
        {
            "publishedDate": "2025-08-29T10:01:01.342Z",
            "updateCategory": "wcUpdateCat:C4",
            "added": [
                {
                    "value": "wcChangeArea:NM_INFM",
                    "valueDataType": "wcDataType:Q_CODE",
                    "idRefs": [
                        "83f96556742656b76acf4bebacb5ea91",
                        "0e48d2b651fbe43e76c23ead0867e5fd",
                        "1e73a6dcbad5f7a0382f8a2b6a5085a2",
                        "44732333add684bf447ed6264e3a6f77"
                    ]
                }
            ]
        }
    ]
}

Initial Published Date

This initialPublishedDate value contains the timestamp indicating when the record was first made available in World-Check On Demand. For consistency and continuity, the value for this field is equivalent to the CREATED date of records with the same UID in World-Check Data File up to 8 August 2025. Newly added records after that date will have different timestamps between these two systems as records are published immediately in World-Check On Demand.

The timestamp is immutable and will remain the same throughout the lifetime of the record.

Last Published Date

The lastPublishedDate value is the timestamp indicating when the most recent update for the record UID was made publicly available. World-Check On Demand only provides the latest full details of records (i.e., it does not provide a historical snapshot) and this timestamp reflects the publication time of the record details being returned.

In constrast to initialPublishedDate, this timestamp will change when an update to the record is made available.

Change History

Provides a list of changes to the record within a specified lookback period. Each entry contains the Update Category for the changes, along with the list of record areas for each type of change: added, updated, deleted. Field IDs are also included for added and updated information, allowing the ingesting application to potentially use these details for decision making, workflow automation, and other forms of branching logic.

The changeHistory is dynamically generated on request, with the lookback range being determined by the starting lastPublishedDate in the query request payload.

A simple delta request payload with a lookback period that starts at 1030H of 15 August 2025.
{
    "criteria": {
        "field": "lastPublishedDate",
        "operator": "gt",
        "value": "2025-08-15T10:30:00.000Z"
    }
}

In the above example, the lookback period starts at 1030H of 15 August 2025. The API will return all new and updated records after this time up to query request time. Each returned record will contain a change history that shows all publication times, update categories, and field IDs of changes within that entire range.

"changeHistory": [
        {
            "publishedDate": "2025-08-15T12:33:02.593Z",
            "updateCategory": "wcUpdateCat:C4",
            "added": [
                {
                    "value": "wcChangeArea:FTHR_INFM",
                    "valueDataType": "wcDataType:Q_CODE",
                    "idRefs": [
                        "38e8a54b77d5a32fb10ffaf87f16b252"
                    ]
                },
            ],
            "updated": [
                {
                    "value": "wcChangeArea:SRC_REF_LST",
                    "valueDataType": "wcDataType:Q_CODE",
                    "idRefs": [
                        "8fb6ce35dfe2b5ab5d8481dc9dd4036f",
                        "9c86150ffaad12fbcff92726ada4d0a2",
                        "aca6ddce409a7bd12f1b448e0389394a"
                    ]
                }
            ],
            "removed": [
                {
                    "value": "wcChangeArea:FTHR_INFM",
                    "valueDataType": "wcDataType:Q_CODE"
                }
            ]
        },

`publishedDate`

The timestamp value when this specific change was made publicly available by World-Check On Demand. The latest entry in the changeReferenceList array will have the same value as lastPublishedDate.

`updateCategory`

The World-Check category for update types indicating the level of criticality. Clients must evaluate if these categorisations are consistent with policies and expectations. Alternatively, clients can make decisions based on fields that changed and/or actual changes to these fields.

Update Category	Description
wcUpdateCat:C0	New or Reactivated Record
wcUpdateCat:C1	Most Critical Update
wcUpdateCat:C2	Very Critical Update
wcUpdateCat:C3	Somewhat Critical Update
wcUpdateCat:C4	Least Critical Update
wcUpdateCat:C5	Non-Public Changes (will not be published)
wcUpdateCat:C6	Non-Material Change

`added`

Contains details regarding data points that had been added within a specific record update.

value: Indicates the area within the record where a data point was added.

Record Change Areas	Description
wcChangeArea:CNCTN_INFM	Connection Information
wcChangeArea:CTG_INFM	Category Information
wcChangeArea:DTE_INFM	Date Information
wcChangeArea:EVT_INFM	Event Information
wcChangeArea:FTHR_INFM	Further Information
wcChangeArea:GENDER_INFM	Gender Information
wcChangeArea:ID_INFM	Identification Information
wcChangeArea:KWD_REF_LST	Keyword Reference List
wcChangeArea:LCT_INFM	Location Information
wcChangeArea:NM_INFM	Name Information
wcChangeArea:PEP_INFM	PEP Role Information
wcChangeArea:RCD_DT_INFM	Record Date Information
wcChangeArea:RLTD_SBJCT_INFM	Related Subject Information
wcChangeArea:SRC_REF_LST	Source Reference List
wcChangeArea:SUB_STAT_INFM	Subject Status
wcChangeArea:SUB_TYPE	Record Sub-type

idRefs: One or more field object IDs (id) that were added within a specific record update.

`updated`

Contains details regarding data points that had been updated within a specific record update.

value: Indicates the area within the record where a data point was updated.
idRefs: One or more field object IDs (id) that were updated within a specific record update.

info

Due to current internal constraints, updates to data points will appear as a combination of removed and added for some time. For example, if there is an update to the existing date of birth, the change history will reflect as a combination of (a) removal of the previous value, and (b) addition of a new value.

`removed`

Contains details regarding data points that had been updated within a specific record update.

value: Indicates the area within the record where a data point was removed.

The field object ID will not be provided for removals because they are not present anymore in the record update.

Record​

Unique Identifier (UID)​

uid​

Language​

language​

Record Types & Record Sub-Types​

recordType​

recordSubTypes​

id​

Record Status​

details​

details.value​

Keyword Reference List​

id​

keyword​

currentFrom​

currentTo​

effectiveFrom​

effectiveTo​

status.value​

Keyword Tagging​

relations​

rel​

value​

valueDataType​

Record Date Information​

type​

value​

Category Information​

categoryPath​

Name Information​

details.role​

details.value​

relations​

relations.rel​

relations.value​

relations.valueDataType​

rel​

value​

Gender Information​

details.value​

Location Information​

type​

effectiveFrom​

status.value​

details.role​

details.value​

Date Information​

type​

details.value​

details.valueDataType​

Identification Information​

type​

details.value​

relations.value​

PEP Role Information​

role​

level​

position​

effectiveFrom​

effectiveTo​

status​

roleBiography​

locationInformation​

Connection Information​

type​

relations.rel​

relations.value​

value​

valueDataType​

Related Subject Information​

details.role​

details.value​

details.relations​

Further Information​

details.role​

details.value​

Source Reference List​

type​

role​

Record

Unique Identifier (UID)

`uid`

Language

`language`

Record Types & Record Sub-Types

`recordType`

`recordSubTypes`

`id`

Record Status

`details`

`details.value`

Keyword Reference List

`id`

`keyword`

`currentFrom`

`currentTo`

`effectiveFrom`

`effectiveTo`

`status.value`

Keyword Tagging

`relations`

`rel`

`value`

`valueDataType`

Record Date Information

`type`

`value`

Category Information

`categoryPath`

Name Information

`details.role`

`details.value`

`relations`

`relations.rel`

`relations.value`

`relations.valueDataType`

`rel`

`value`

Gender Information

`details.value`

Location Information

`type`

`effectiveFrom`

`status.value`

`details.role`

`details.value`

Date Information

`type`

`details.value`

`details.valueDataType`

Identification Information

`type`

`details.value`

`relations.value`

PEP Role Information

`role`

`level`

`position`

`effectiveFrom`

`effectiveTo`

`status`

`roleBiography`

`locationInformation`

Connection Information

`type`

`relations.rel`

`relations.value`

`value`

`valueDataType`

Related Subject Information

`details.role`

`details.value`

`details.relations`

Further Information

`details.role`

`details.value`

Source Reference List

`type`

`role`