Artha API
  1. Cards
  • Introduction
  • Authentication
  • KYC/KYB Requirements
  • API Setup Guide
  • Customers
    • Create Customer
      POST
    • List Customers
      GET
    • Get Customer
      GET
    • Update Customer
      PATCH
  • Cards
    • Submit KYC/KYB Applicant
      POST
    • Issue Card
      POST
    • Cards List
      GET
    • Get Card
      GET
    • Get Sensitive Card Details
      GET
  • Card Operations
    • Activate Card
      POST
    • Freeze Card
      POST
    • Unfreeze Card
      POST
    • Cancel Card
      POST
    • Replace Card
      POST
    • Set / Reset Card PIN
      POST
    • Get Card Limits
      GET
    • Update Card Limits
      POST
  • Funding
    • Top Up Card
      POST
    • Get Card Balance
      GET
    • List Top-Up History
      GET
  • Transactions
    • List All Transactions
      GET
    • List Card Transactions
      GET
    • List Customer Transactions
      GET
    • Get Transaction
      GET
  • Products
    • List Products
    • Get Product
  • Utilities
    • Upload Documents
  • Webhook's
    • Webhooks
  1. Cards

Submit KYC/KYB Applicant

POST
/{{baseurl}}/api/v1/customers/{customerId}/products/{productId}/applicant
Submit KYC (individual) or KYB (business) verification details.
For individuals – send the kycDetails object
For businesses – send the kybDetails object
📎 All file fields must contain URLs from POST /api/v1/uploadfile.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200
KYC/KYB submitted successfully.
This response does not have a body.
🟠401
🟠404
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location -g --request POST '/{{baseurl}}/api/v1/customers//products//applicant' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "kycDetails": {
        "firstName": "Jane",
        "lastName": "Doe",
        "gender": "female",
        "dob": "1990-06-15",
        "email": "jane@example.com",
        "mobileCode": "+44",
        "mobile": "7700900000",
        "address": "10 Downing Street",
        "addressLine2": "Flat 2",
        "city": "London",
        "state": "England",
        "zipCode": "SW1A 2AA",
        "countryId": "GB",
        "countryIsoThree": "GBR",
        "town": "Westminster",
        "docType": "passport",
        "docId": "AB1234567",
        "frontDoc": "https://storage.blob.core.windows.net/docs/passport_front.jpg",
        "backDoc": "https://storage.blob.core.windows.net/docs/passport_back.jpg",
        "docExpireDate": "2030-01-01",
        "docIssueDate": "2020-01-01",
        "photo": "https://storage.blob.core.windows.net/docs/selfie.jpg",
        "signImage": "https://storage.blob.core.windows.net/docs/signature.png",
        "handHoldIdPhoto": "https://storage.blob.core.windows.net/docs/hand_hold.jpg",
        "occupation": "software_engineer",
        "accountPurpose": "personal_spending",
        "annualSalary": 75000,
        "expectedMonthlyVolume": 5000,
        "ipAddress": "192.168.1.1"
    }
}'
Modified at 2026-02-19 17:53:55
Previous
Update Customer
Next
Issue Card
Built with