Artha API
  1. Utilities
  • 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
    • List Card Transactions
    • List Customer Transactions
    • Get Transaction
  • Products
    • List Products
    • Get Product
  • Utilities
    • Upload Documents
      POST
  • Webhook's
    • Webhooks
  1. Utilities

Upload Documents

POST
{{baseUrl}}/api/v1/uploadfile
Upload one or more documents (images, PDFs) to Azure Blob Storage. Returns a file URL for each uploaded file.
Use this endpoint before submitting KYC/KYB applications. The returned file_url values should be passed as document fields (e.g., profilePicFront, frontDocument, selfie, certificateofincorporation) in the KYC/KYB applicant request.

📋 Supported File Types#

TypeExtensions
Images.jpg, .jpeg, .png
Documents.pdf

⚠️ Constraints#

Files are sent as multipart/form-data
Multiple files can be uploaded in a single request
Each file has a maximum size limit (check with your ArthaPay account manager)

📤 Response Fields (per file)#

FieldTypeDescription
file_namestringOriginal file name
file_urlstringAzure Blob Storage URL — use this in KYC/KYB submissions

Request

Header Params

Body Params multipart/form-dataRequired

Responses

🟢200
application/json
Files uploaded successfully.
Body

🟠401
🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{baseUrl}}/api/v1/uploadfile' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--form 'files=""'
Response Response Example
200 - Single file upload
{
    "data": [
        {
            "file_name": "passport_front.jpg",
            "file_url": "https://storage.blob.core.windows.net/docs/abc123-passport_front.jpg"
        }
    ],
    "request_id": "req_upload_001",
    "timestamp": "2024-01-15T10:30:00Z"
}
Modified at 2026-02-18 16:57:35
Previous
Get Product
Next
Webhooks
Built with