Skip to main content
POST
/
documentmanagement
/
attach-documents
Submit KYC Documents
curl --request POST \
  --url https://{tenant}.fincode.software/api/v6/services/documentmanagement/attach-documents/ \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --form 'customerCode=<string>' \
  --form documentType=PROOF_OF_ADDRESS \
  --form document='@example-file' \
  --form 'kycRuleId=<string>'
This endpoint allows you to submit KYC (Know Your Customer) documents for a customer. Use this after retrieving pending requirements from the Awaiting Compliance endpoint.

​
Request Headers

This endpoint requires a valid Access Token for authorization.
​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
platform
string
default:"fincode"
required
Platform identifier. Use fincode.
​
uuid
string
default:"200"
required
Unique request identifier.

​
Request Body

​
customerCode
string
required
The unique customer identifier for whom the documents are being submitted.
​
documentType
string
required
The type of KYC document being submitted. Supported values:
  • PROOF_OF_ADDRESS - Utility bill, bank statement, or government letter
  • ID_VERIFICATION - Government-issued ID
  • PASSPORT - Valid passport
  • DRIVERS_LICENSE - Valid driver’s license
  • UTILITY_BILL - Recent utility bill
  • BANK_STATEMENT - Recent bank statement
​
document
file
required
The document file to upload. Supported formats: PDF, JPG, PNG.
​
kycRuleId
string
Optional KYC rule ID if submitting for a specific compliance requirement returned from the awaiting compliance endpoint.

​
Response

​
status
string
default:"SUCCESS"
Overall status of the API request.
​
message
string
A descriptive message about the submission result.
​
data
object
Container for the submission result data.

​
Code Examples

curl --location 'https://remitjunction.fincode.software/api/v6/services/compliance/attach-documents' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'platform: fincode' \
--header 'uuid: 200' \
--form 'customerCode="CUST123456"' \
--form 'documentType="PROOF_OF_ADDRESS"' \
--form 'document=@"/path/to/document.pdf"'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
X-Auth-Token
string
required

Body

multipart/form-data
​
customerCode
string
required

The unique customer identifier

​
documentType
enum<string>
required

Type of KYC document being submitted

Available options:
PROOF_OF_ADDRESS,
ID_VERIFICATION,
PASSPORT,
DRIVERS_LICENSE,
UTILITY_BILL,
BANK_STATEMENT
​
document
file
required

The document file to upload

​
kycRuleId
string

Optional KYC rule ID if submitting for a specific compliance requirement

Response

200

KYC documents submitted successfully