Submit KYC Declaration

curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "declarationAccepted": true,
    "deviceId": "device_abc123"
  }'

{
  "success": true,
  "message": "Declaration submitted successfully",
  "data": {
    "declarationId": "decl_abc123def456",
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "submittedAt": "2025-06-15T10:40:00.000Z"
  }
}

{
  "success": false,
  "error": "KYC Rejected",
  "message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
  "data": {
    "declarationId": "decl_abc123def456",
    "isPep": true,
    "kycStatus": "rejected"
  }
}

POST

users

{userId}

kyc

declaration

curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "declarationAccepted": true,
    "deviceId": "device_abc123"
  }'

{
  "success": true,
  "message": "Declaration submitted successfully",
  "data": {
    "declarationId": "decl_abc123def456",
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "submittedAt": "2025-06-15T10:40:00.000Z"
  }
}

{
  "success": false,
  "error": "KYC Rejected",
  "message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
  "data": {
    "declarationId": "decl_abc123def456",
    "isPep": true,
    "kycStatus": "rejected"
  }
}

Overview

Submit the user’s declaration information as part of the extended KYC process. This includes occupation, income range, and Politically Exposed Person (PEP) status.

If the user declares themselves as a Politically Exposed Person (PEP), their KYC will be automatically rejected.

Occupation Types

Value	Description
`salaried`	Salaried Employee
`self_employed`	Self-Employed
`business`	Business Owner
`professional`	Professional (Doctor, Lawyer, etc.)
`student`	Student
`retired`	Retired
`homemaker`	Homemaker
`unemployed`	Unemployed
`other`	Other (specify in occupationOther)

Income Ranges (Annual)

Value	Range (INR)
`below_5l`	Below 5 Lakhs
`5l_to_10l`	5 - 10 Lakhs
`10l_to_25l`	10 - 25 Lakhs
`25l_to_50l`	25 - 50 Lakhs
`50l_to_1cr`	50 Lakhs - 1 Crore
`above_1cr`	Above 1 Crore

Request Body

occupation

string

required

User’s occupation type

occupationOther

string

Specify occupation if “other” is selected (max 100 characters)

incomeRange

string

required

User’s annual income range

isPep

boolean

required

Whether the user is a Politically Exposed Person

pepDetails

string

Additional PEP details if isPep is true (max 500 characters)

declarationAccepted

boolean

required

Must be true - user accepts the declaration terms

deviceId

string

Unique device identifier for FIU compliance

Response

success

boolean

Whether the declaration was submitted successfully

message

string

Success or error message

data

object

Show properties

declarationId

string

Unique identifier for the declaration

occupation

string

Submitted occupation

incomeRange

string

Submitted income range

isPep

boolean

PEP status

submittedAt

string

ISO 8601 timestamp when declaration was submitted

curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "declarationAccepted": true,
    "deviceId": "device_abc123"
  }'

{
  "success": true,
  "message": "Declaration submitted successfully",
  "data": {
    "declarationId": "decl_abc123def456",
    "occupation": "salaried",
    "incomeRange": "10l_to_25l",
    "isPep": false,
    "submittedAt": "2025-06-15T10:40:00.000Z"
  }
}

{
  "success": false,
  "error": "KYC Rejected",
  "message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
  "data": {
    "declarationId": "decl_abc123def456",
    "isPep": true,
    "kycStatus": "rejected"
  }
}

Verify Bank Account Get KYC Status

​Overview

​Occupation Types

​Income Ranges (Annual)

​Request Body

​Response

Overview

Occupation Types

Income Ranges (Annual)

Request Body

Response