botsKYC API Gateway - Production

Risk & Compliance

Endpoint:https://api.botskyc.com

Sanctions Screen - AML & PEP Watchlists

POST

https://api.botskyc.com

/v1/sanctions/screen

Screen a name against global sanctions and PEP lists for AML compliance

Sanctions Screen - AML & PEP Watchlists › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Sanctions Screen - AML & PEP Watchlists › Responses

Screening completed

Sanctions screening result

query

string

matched

boolean

matchCount

integer

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

CRITICAL

object[]

POST/v1/sanctions/screen

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Enhanced Sanctions Screening

POST

https://api.botskyc.com

/v1/sanctions/screen/enhanced

Enhanced AI-powered screening with additional data sources and Gemini enrichment

Enhanced Sanctions Screening › query Parameters

enrich

boolean

Enable AI enrichment

Default: true

Enhanced Sanctions Screening › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Enhanced Sanctions Screening › Responses

Enhanced screening completed

Sanctions screening result

query

string

matched

boolean

matchCount

integer

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

CRITICAL

object[]

POST/v1/sanctions/screen/enhanced

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen/enhanced \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Adverse Media - News & Media Screening

POST

https://api.botskyc.com

/v1/sanctions/screen/adverse-media

Screen for adverse media mentions, legal issues, and reputational risks

Adverse Media - News & Media Screening › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Adverse Media - News & Media Screening › Responses

Adverse media screening completed

query

string

hasAdverseMedia

boolean

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

object[]

POST/v1/sanctions/screen/adverse-media

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen/adverse-media \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Risk Score - AI Transaction Risk Analysis

POST

https://api.botskyc.com

/v1/sanctions/risk-score

Calculate comprehensive risk score for an individual or entity per FIA guidelines

Risk Score - AI Transaction Risk Analysis › query Parameters

includeAdverseMedia

boolean

Include adverse media in calculation

Default: true

Risk Score - AI Transaction Risk Analysis › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Risk Score - AI Transaction Risk Analysis › Responses

Risk score calculated

name

string

overallScore

number · min: 0 · max: 100

riskLevel

string · enum

Enum values:

LOW

MEDIUM

HIGH

CRITICAL

recommendation

string · enum

Enum values:

APPROVE

REVIEW

REJECT

object

POST/v1/sanctions/risk-score

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/risk-score \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Business Verification Document Forensics

botsKYC API Gateway - Production

Risk & Compliance

Endpoint:https://api.botskyc.com

Sanctions Screen - AML & PEP Watchlists

POST

https://api.botskyc.com

/v1/sanctions/screen

Screen a name against global sanctions and PEP lists for AML compliance

Sanctions Screen - AML & PEP Watchlists › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Sanctions Screen - AML & PEP Watchlists › Responses

Screening completed

Sanctions screening result

query

string

matched

boolean

matchCount

integer

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

CRITICAL

object[]

POST/v1/sanctions/screen

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Enhanced Sanctions Screening

POST

https://api.botskyc.com

/v1/sanctions/screen/enhanced

Enhanced AI-powered screening with additional data sources and Gemini enrichment

Enhanced Sanctions Screening › query Parameters

enrich

boolean

Enable AI enrichment

Default: true

Enhanced Sanctions Screening › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Enhanced Sanctions Screening › Responses

Enhanced screening completed

Sanctions screening result

query

string

matched

boolean

matchCount

integer

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

CRITICAL

object[]

POST/v1/sanctions/screen/enhanced

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen/enhanced \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Adverse Media - News & Media Screening

POST

https://api.botskyc.com

/v1/sanctions/screen/adverse-media

Screen for adverse media mentions, legal issues, and reputational risks

Adverse Media - News & Media Screening › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Adverse Media - News & Media Screening › Responses

Adverse media screening completed

query

string

hasAdverseMedia

boolean

riskLevel

string · enum

Enum values:

CLEAR

LOW

MEDIUM

HIGH

object[]

POST/v1/sanctions/screen/adverse-media

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/screen/adverse-media \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Risk Score - AI Transaction Risk Analysis

POST

https://api.botskyc.com

/v1/sanctions/risk-score

Calculate comprehensive risk score for an individual or entity per FIA guidelines

Risk Score - AI Transaction Risk Analysis › query Parameters

includeAdverseMedia

boolean

Include adverse media in calculation

Default: true

Risk Score - AI Transaction Risk Analysis › Request Body

Request to screen a person or entity against sanctions lists

name

string · required

Full name to screen

country

string

Country code (ISO 3166-1 alpha-2)

dateOfBirth

string · date

Date of birth for better matching

entityType

string · enum

Enum values:

individual

organization

Default: individual

Risk Score - AI Transaction Risk Analysis › Responses

Risk score calculated

name

string

overallScore

number · min: 0 · max: 100

riskLevel

string · enum

Enum values:

LOW

MEDIUM

HIGH

CRITICAL

recommendation

string · enum

Enum values:

APPROVE

REVIEW

REJECT

object

POST/v1/sanctions/risk-score

curl --request POST \
  --url https://api.botskyc.com/v1/sanctions/risk-score \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}
'

shell

Request Body Example

{
  "name": "John Smith",
  "country": "BW",
  "dateOfBirth": "2024-08-25",
  "entityType": "individual"
}

json

Business Verification Document Forensics