botsKYC API Gateway - Production

Document Forensics

Endpoint:https://api.botskyc.com

Full Forensics Analysis - Detect Tampering

POST

https://api.botskyc.com

/v1/forensics/analyze

Comprehensive document forensic analysis for tampering, Photoshop detection, and metadata analysis

Full Forensics Analysis - Detect Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Full Forensics Analysis - Detect Tampering › Responses

Forensic analysis completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/analyze

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/analyze \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

Quick Forensic Check

POST

https://api.botskyc.com

/v1/forensics/quick

Fast metadata-only analysis for common tampering signs

Quick Forensic Check › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Quick Forensic Check › Responses

Quick scan completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/quick

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/quick \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

ID Forensics - Detect Tampered IDs

POST

https://api.botskyc.com

/v1/forensics/identity

Forensic analysis specialized for identity documents (Omang, Passport, Driver's License)

ID Forensics - Detect Tampered IDs › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

ID Forensics - Detect Tampered IDs › Responses

ID forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/identity

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/identity \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

Income Forensics - Detect Payslip Tampering

POST

https://api.botskyc.com

/v1/forensics/income

Forensic analysis for income documents (payslips, tax returns, bank statements)

Income Forensics - Detect Payslip Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Income Forensics - Detect Payslip Tampering › Responses

Income forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/income

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/income \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

Address Forensics - Detect Utility Bill Tampering

POST

https://api.botskyc.com

/v1/forensics/address

Forensic analysis for address proof documents (utility bills, bank statements)

Address Forensics - Detect Utility Bill Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Address Forensics - Detect Utility Bill Tampering › Responses

Address forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/address

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/address \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

Business Forensics - Detect Certificate Tampering

POST

https://api.botskyc.com

/v1/forensics/business

Forensic analysis for business registration documents and CIPA certificates

Business Forensics - Detect Certificate Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Business Forensics - Detect Certificate Tampering › Responses

Business forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

POST/v1/forensics/business

curl --request POST \
  --url https://api.botskyc.com/v1/forensics/business \
  --header 'Content-Type: application/json' \
  --data '
{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}
'

shell

Request Body Example

{
  "file": "file",
  "mode": "full",
  "document_type": "unknown"
}

json

Forensics Service Health

GET

https://api.botskyc.com

/v1/forensics/health

Check forensics service health status

Forensics Service Health › Responses

Service is healthy

status

string

service

string

version

string

Supported Forensics Formats

GET

https://api.botskyc.com

/v1/forensics/formats

Get list of supported file formats for document forensics (PDF, JPEG, PNG, etc.)

Supported Forensics Formats › Responses

List of supported formats

formats

string[]

max_file_size_mb

integer

Risk & Compliance

Full Forensics Analysis - Detect Tampering

POST

https://api.botskyc.com

/v1/forensics/analyze

Comprehensive document forensic analysis for tampering, Photoshop detection, and metadata analysis

Full Forensics Analysis - Detect Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Full Forensics Analysis - Detect Tampering › Responses

Forensic analysis completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

Quick Forensic Check

POST

https://api.botskyc.com

/v1/forensics/quick

Fast metadata-only analysis for common tampering signs

Quick Forensic Check › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Quick Forensic Check › Responses

Quick scan completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

ID Forensics - Detect Tampered IDs

POST

https://api.botskyc.com

/v1/forensics/identity

Forensic analysis specialized for identity documents (Omang, Passport, Driver's License)

ID Forensics - Detect Tampered IDs › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

ID Forensics - Detect Tampered IDs › Responses

ID forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

Income Forensics - Detect Payslip Tampering

POST

https://api.botskyc.com

/v1/forensics/income

Forensic analysis for income documents (payslips, tax returns, bank statements)

Income Forensics - Detect Payslip Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Income Forensics - Detect Payslip Tampering › Responses

Income forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

Address Forensics - Detect Utility Bill Tampering

POST

https://api.botskyc.com

/v1/forensics/address

Forensic analysis for address proof documents (utility bills, bank statements)

Address Forensics - Detect Utility Bill Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Address Forensics - Detect Utility Bill Tampering › Responses

Address forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object

Business Forensics - Detect Certificate Tampering

POST

https://api.botskyc.com

/v1/forensics/business

Forensic analysis for business registration documents and CIPA certificates

Business Forensics - Detect Certificate Tampering › Request Body

Document forensics analysis request. Send as multipart/form-data.

file

string · binary · required

Document to analyze

mode

string · enum

Enum values:

full

quick

Default: full

document_type

string · enum

Enum values:

unknown

identity

income

address

business

Business Forensics - Detect Certificate Tampering › Responses

Business forensics completed

Document forensics analysis result

documentId

string

verdict

string · enum

Enum values:

AUTHENTIC

SUSPICIOUS

TAMPERED

INCONCLUSIVE

confidenceScore

number · min: 0 · max: 100

riskScore

number · min: 0 · max: 100

object[]

object