Verification Document Management API

curl --request GET \
  --url https://sandbox.finhub.cloud/api/v2.1/verifications/{verificationId}/documents \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-ID: <x-tenant-id>' \
  --data '
{
  "category": "<string>"
}
'

{
  "success": true,
  "data": {
    "documents": [
      {
        "documentId": "doc_12345",
        "documentType": "GOVERNMENT_ID",
        "status": "VERIFIED",
        "uploadedAt": "2024-01-15T10:30:00Z"
      },
      {
        "documentId": "doc_67890",
        "documentType": "PROOF_OF_ADDRESS",
        "status": "PENDING_REVIEW",
        "uploadedAt": "2024-01-15T10:35:00Z"
      }
    ]
  }
}

GET

https://sandbox.finhub.cloud

api

v2.1

verifications

{verificationId}

documents

Verification Document Management API

curl --request GET \
  --url https://sandbox.finhub.cloud/api/v2.1/verifications/{verificationId}/documents \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'X-Tenant-ID: <x-tenant-id>' \
  --data '
{
  "category": "<string>"
}
'

{
  "success": true,
  "data": {
    "documents": [
      {
        "documentId": "doc_12345",
        "documentType": "GOVERNMENT_ID",
        "status": "VERIFIED",
        "uploadedAt": "2024-01-15T10:30:00Z"
      },
      {
        "documentId": "doc_67890",
        "documentType": "PROOF_OF_ADDRESS",
        "status": "PENDING_REVIEW",
        "uploadedAt": "2024-01-15T10:35:00Z"
      }
    ]
  }
}

Verification Document Management API

APIs for uploading and managing documents associated with verification processes.

Base URL: https://sandbox.finhub.cloud

Available Operations

Get Documents

GET /verifications/{id}/documents

Upload Document

POST /verifications/{id}/documents

Get Verification Documents

Retrieves all documents for a specific verification process.

Request

verificationId

string

required

Verification identifier

Authorization

string

required

Bearer token for authentication

X-Tenant-ID

string

required

Tenant identifier

Code Examples

curl -X GET "https://sandbox.finhub.cloud/api/v2.1/verifications/ver_12345/documents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

{
  "success": true,
  "data": {
    "documents": [
      {
        "documentId": "doc_12345",
        "documentType": "GOVERNMENT_ID",
        "status": "VERIFIED",
        "uploadedAt": "2024-01-15T10:30:00Z"
      },
      {
        "documentId": "doc_67890",
        "documentType": "PROOF_OF_ADDRESS",
        "status": "PENDING_REVIEW",
        "uploadedAt": "2024-01-15T10:35:00Z"
      }
    ]
  }
}

Upload Verification Document

Uploads a document for a specific verification process.

Request

verificationId

string

required

Verification identifier

documentType

string

required

Type of document: GOVERNMENT_ID, PROOF_OF_ADDRESS, SELFIE, etc.

documentId

string

Optional document ID (for re-uploads)

Authorization

string

required

Bearer token for authentication

X-Tenant-ID

string

required

Tenant identifier

X-User-Id

string

Uploading user ID

file

required

Document file (multipart/form-data)

Code Examples

curl -X POST "https://sandbox.finhub.cloud/api/v2.1/verifications/ver_12345/documents?documentType=GOVERNMENT_ID" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -F "file=@/path/to/passport.pdf"

{
  "success": true,
  "data": {
    "documentId": "doc_11111",
    "verificationId": "ver_12345",
    "documentType": "GOVERNMENT_ID",
    "status": "UPLOADED",
    "uploadedAt": "2024-01-15T10:30:00Z"
  }
}

Document Types

Type	Description
`GOVERNMENT_ID`	Passport, national ID, driver’s license
`PROOF_OF_ADDRESS`	Utility bill, bank statement (< 3 months)
`SOURCE_OF_FUNDS`	Income proof, tax returns
`SELFIE`	Customer selfie for liveness check
`CERTIFICATE_OF_INCORPORATION`	Company registration
`BENEFICIAL_OWNER_DECLARATION`	UBO declaration

Document Statuses

Status	Description
`UPLOADED`	Document uploaded
`PENDING_REVIEW`	Awaiting review
`VERIFIED`	Document verified
`REJECTED`	Document rejected

Response Codes

Code	Description
`200`	Documents retrieved successfully
`201`	Document uploaded successfully
`400`	Invalid request data
`404`	Verification not found
`500`	Internal server error

Consent Verification API Administration

⌘I

Client Categories

Product Suite

Service Models

CoreX Service Model

API Service Model

Hybrid Service Model

Verification Document Management API

Verification Document Management API

Available Operations

Get Documents

Upload Document

Get Verification Documents

Request

Code Examples

Upload Verification Document

Request

Code Examples

Document Types

Document Statuses

Response Codes

Client Categories

Product Suite

Service Models

CoreX Service Model

API Service Model

Hybrid Service Model

​Verification Document Management API

​Available Operations

Get Documents

Upload Document

​Get Verification Documents

​Request

​Code Examples

​Upload Verification Document

​Request

​Code Examples

​Document Types

​Document Statuses

​Response Codes

Verification Document Management API

Available Operations

Get Verification Documents

Request

Code Examples

Upload Verification Document

Request

Code Examples

Document Types

Document Statuses

Response Codes