World-Check Verify (1.0.0)

World-Check Verify provides a stateless, real-time screening solution designed for easy integration into your existing onboarding or transaction workflows. The API provides:

  • The ability to screen entity names, with or without secondary fields such as date of birth for individuals, country of registration for organisations, etc.
  • The ability to retrieve matched watchlist record details.
  • Access to reference data that can be used for screening purposes.

    © 2025 LSEG. All rights reserved. Republication or redistribution of LSEG content, including by framing or similar means, is prohibited without the prior written consent of LSEG. 'LSEG' and the LSEG logo are registered trademarks and trademarks of LSEG and its affiliated companies.

screen

Screen names and secondary identifiers

Use this endpoint to screen names and secondary identifiers of an entity against the selected datasets.

To perform initial (full) screen, send the request with necessary screening data of the entity without "startScreeningDate". This will perform a full screen against selected datasets.

To perform delta screening (screening against new and updated data since the entity was last screened), you may store the index date from the response "lastIndexDatesByCheckType" and give this date value in the "startScreeningDate" field as part the request. Ensure the name and other details given in the request are same as the initial screen.

Note: If the settings or the entity details have been changed since the last screen, then it is recommended to perform a full screen, as the delta screen may not capture all the updates.

Note: In names and secondary fields where free text is allowed, any symbol is allowed except control characters like '\n' (new line) and '\t' (tab). Additionally, using operator words even when combined with an apostrophe, for example the below combinations, may cause an error 403 to be returned:

  • String ‘AND (String)
  • String ‘OR (String)
  • String ‘AND NOT (String)
  • String ‘OR NOT (String)
  • String ‘AND AS (String)
  • String ‘OR AS (String)
header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Content-Type
required
string

The media type of the request (e.g., 'application/json')

Content-Length
required
integer

The length of the request body in octets (8-bit bytes)

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Request Body schema: application/json

Screen payload.

required
Array of objects (Name) [ 1 .. 3 ] items [ items ]

Represents names to be screened.

groupId
required
string <= 255 characters

Group identifier. The settings of this group will be used for screening.

entityType
required
string (ScreeningEntityType)
Enum: "INDIVIDUAL" "ORGANISATION" "VESSEL" "UNSPECIFIED"

Entity type enumeration.

checkTypes
required
Array of strings (ProviderType) 1 items unique
Items Value: "WORLD_CHECK"

Check types required for screening.

Array of objects (Field) <= 24 items [ items ]

Secondary fields.

nameTransposition
boolean

Enable this option when screening a name of 2 or more parts and are unsure of the order. Only applicable for Individuals.

startScreeningDate
string <date-time>

The request will be screened against records that are published "from" the given date. This date must be in 'ISO 8601' format and less than the current date.

Responses

Request samples

Content type
application/json
{
  • "names": [
    ],
  • "groupId": "string",
  • "entityType": "INDIVIDUAL",
  • "checkTypes": [
    ],
  • "secondaryFields": [
    ],
  • "nameTransposition": true,
  • "startScreeningDate": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "names": [
    ],
  • "checkTypes": [
    ],
  • "groupId": "string",
  • "entityType": "INDIVIDUAL",
  • "secondaryFields": [
    ],
  • "nameTransposition": true,
  • "startScreeningDate": "2019-08-24T14:15:22Z",
  • "lastIndexDatesByCheckType": {
    },
  • "requestor": {
    },
  • "results": [
    ]
}

groups

Get all groups for the identified users.

  • If no query parameters are given, then by default the response will show all the hierarchy including all the descendant groups.
query Parameters
showAllChildGroups
required
boolean

If set to false, shows only high-level groups and its immediate descendants.

header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Responses

Request samples

HttpResponse<String> response = Unirest.get("https://api.ap.risk.lseg.com/zfs/v1/groups?showAllChildGroups=SOME_BOOLEAN_VALUE")
  .asString();

Response samples

Content type
application/json
[
  • {
    }
]

references

Get array of countries with country codes and country names.

Get array of countries with 'ISO-3166-1 alpha-3' country codes and country names in English.

header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Responses

Request samples

HttpResponse<String> response = Unirest.get("https://api.ap.risk.lseg.com/zfs/v1/references/countries")
  .asString();

Response samples

Content type
application/json
{
  • "countries": [
    ]
}

Get identity document location types.

Get each identity document location type, that refers to a specific country and entity type.

header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Responses

Request samples

HttpResponse<String> response = Unirest.get("https://api.ap.risk.lseg.com/zfs/v1/references/identity-documents")
  .asString();

Response samples

Content type
application/json
{
  • "identityDocumentLocationTypes": [
    ]
}

Get a record by its ID

Get a record by its ID. This service returns a specific subclass of 'Entity', depending on its particular 'RecordEntityType' discriminator field. Please note in the context of World-Check Verify, 'Record' and 'Entity' are synonymous concepts.

The 'Entity' subclasses corresponding to each type of entity are:

'COUNTRY' : 'CountryEntity'
'INDIVIDUAL' : 'IndividualEntity'
'ORGANISATION' : 'OrganisationEntity'
'VESSEL' : 'VesselEntity'
path Parameters
id
required
string

Record identifier.

header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Responses

Request samples

HttpResponse<String> response = Unirest.get("https://api.ap.risk.lseg.com/zfs/v1/references/records/%7Bid%7D")
  .asString();

Response samples

Content type
application/json
Example
{
  • "entityType": "IndividualEntity",
  • "referenceId": "string",
  • "recordStatus": {
    },
  • "recordDates": [
    ],
  • "recordType": {
    },
  • "categories": [
    ],
  • "lastPublishedUpdateCategory": "UNKNOWN",
  • "dates": {
    },
  • "locations": {
    },
  • "names": {
    },
  • "provider": {
    },
  • "identifications": {
    },
  • "connections": {
    },
  • "sources": [
    ],
  • "furtherInformation": {
    },
  • "sourceReferenceLinks": {
    },
  • "translatedEntity": {
    },
  • "statuses": [
    ],
  • "genders": [
    ],
  • "roles": {
    }
}

Get a list of available providers and their sources.

Get a list of available providers and their sources.

header Parameters
Authorization
required
string

The authorization credentials including 'keyId', 'algorithm', 'headers', 'signature' (see 'Security and Authentication details' documentation section for more details).

Date
required
string

The date and time at which the message was originated in 'RFC 1123' format.

Responses

Request samples

HttpResponse<String> response = Unirest.get("https://api.ap.risk.lseg.com/zfs/v1/references/providers")
  .asString();

Response samples

Content type
application/json
[
  • {
    }
]