Upload Document for Verification

This endpoint enables partners to securely upload supporting documents to Netevia's cloud storage as part of the account application review process. Documents submitted through this endpoint are made available to the review team to complete verification and reach a final decision on the application. Supported documents include identity verification materials, financial records, and other required application artifacts.

Endpoint

POST /uploadDocumentForVerification

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when an account application requires additional document submission before a final approval decision can be made. This is typically triggered after an initial application is submitted and the review team requests supporting documentation. Partners should call this endpoint once per document, associating each upload with the relevant profile and document upload session.

Request Body

{
  "profileId": 1048293,
  "documentUploadSessionId": "sess_8f3a21bc-44d1-4e78-b90c-d7e92f6a1234",
  "documentType": "IDENTITY",
  "fileName": "drivers_license_front.jpg",
  "data": "iVBORw0KGgoAAAANSUhEUgAA...",
  "contentType": "image/jpeg",
  "verificatedEntity": "Jane Smith"
}

Response

200 OK

{
  "success": true,
  "errors": null
}

Error Codes

Common Mistakes

• Sending raw binary file content instead of Base64-encoded data in the data field — always encode the file as a Base64 string before submitting.
• Omitting the contentType field or providing an incorrect MIME type, which can cause the document to be stored or rendered incorrectly.
• Reusing an expired or closed documentUploadSessionId — ensure the session is active before uploading additional documents.
• Uploading oversized files without checking platform size limits, which may result in a 400 or 500 error.

Related Endpoints

• POST /api/auth/v2 — Obtain a Bearer token for authentication
• POST /api/auth/refresh — Refresh an existing Bearer token before it expires

Example

curl -X POST https://api.banking.netevia.dev/uploadDocumentForVerification \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": 1048293,
    "documentUploadSessionId": "sess_8f3a21bc-44d1-4e78-b90c-d7e92f6a1234",
    "documentType": "IDENTITY",
    "fileName": "drivers_license_front.jpg",
    "data": "iVBORw0KGgoAAAANSUhEUgAA...",
    "contentType": "image/jpeg",
    "verificatedEntity": "Jane Smith"
  }'