Skip to main content
POST
/
customers
/
{customer_id}
/
kyc
merchant: upload documents
curl --request POST \
  --url https://api-staging.stablestack.xyz/api/customers/{customer_id}/kyc \
  --header 'Content-Type: multipart/form-data' \
  --form document='@example-file' \
  --form doc_type=utility_bill \
  --form doc_country=Nigeria
{
  "status": "success",
  "data": {
    "id": "34f28407-6411-4b8c-9b30-d2654d9bfd1e",
    "customer_id": "85b148ab-3f6b-4d55-917f-3c8de668a48e",
    "doc_country": "Nigeria",
    "doc_type": "all_document",
    "doc_file": "https://res.cloudinary.com/dmllysomu/image/upload/v1746802874/customer_documents/85b148ab-3f6b-4d55-917f-3c8de668a48e_all_document.png",
    "is_doc_verified": false,
    "approval_status": "pending",
    "created_at": "2025-05-01T18:40:26.524Z",
    "updated_at": "2025-05-09T15:01:15.861Z"
  }
}

​
Upload Customer Document

Allows a merchant to upload customer KYC documents. The API validates the customer ID, document type, and country before storing the uploaded file.

​
Key Features

  • Supports document uploads for customer KYC verification
  • Requires a valid customer_id in UUID format
  • Accepts multipart file uploads
  • Validates required fields (doc_type, doc_country, and file presence)
  • Returns the document verification status and approval details

​
Request Body

​
Multipart Form Data

{
  "document": "binary file",
  "doc_type": "all_document",
  "doc_country": "Nigeria"
}

Headers

​
x-api-key
string

Path Parameters

​
customer_id
string
required

Body

multipart/form-data
​
document
file
​
doc_type
enum<string>
Available options:
all_document,
utility_bill,
bank_statement,
proof_of_address,
incorporation,
memorandum,
status_report,
operating_license,
valid_ids,
company_resolution,
aml_policy,
kyc_policy,
data_protection
Example:

"utility_bill"

​
doc_country
string
Example:

"Nigeria"

Response

201 - application/json

Created

The response is of type object.