Verification & Compliance
Shared API surface for managing verification processes, uploading compliance documents, approving submissions, and collecting customer consents. These endpoints are used by both Individual (B2C) and Organization (B2B) onboarding flows.
Base URL: https://sandbox.finhub.cloud/api/v2.1
API Endpoints
Core Verification
Three endpoints handle the full verification lifecycle — from initiation through document upload to admin approval:
| Endpoint | Method | Description |
|---|
/verifications | POST | Initiate a new verification (KYC for individuals, KYB for organizations) |
/verifications/{verificationId}/documents | POST | Upload supporting documents for a verification |
/verifications/{verificationId}/approve | POST | Admin approval after document review |
Consent Collection
Consent endpoints are scoped per customer type. Three consent types must be accepted before activation: terms, privacy, and data-processing.
| Endpoint | Method | Description |
|---|
/customer/individual/{customerId}/consents/{consentType} | POST | Accept a consent for an individual customer |
/customer/organization/{organizationId}/consents/{consentType} | POST | Accept a consent for an organization customer |
Valid values for consentType: terms, privacy, data-processing
Verification Flow
Individual KYC Flow
Step-by-step identity verification for individual (B2C) customers:
| Step | Endpoint | Payload Highlights |
|---|
| 1. Initiate | POST /verifications | type: "IDENTITY_VERIFICATION", customerId |
| 2. Upload ID | POST /verifications/{id}/documents | documentType: "PASSPORT" or "NATIONAL_ID" |
| 3. Upload Address | POST /verifications/{id}/documents | documentType: "PROOF_OF_ADDRESS" |
| 4. Approve | POST /verifications/{id}/approve | Admin reviews and approves |
| 5. Terms | POST /customer/individual/{id}/consents/terms | accepted: true |
| 6. Privacy | POST /customer/individual/{id}/consents/privacy | accepted: true |
| 7. Data Processing | POST /customer/individual/{id}/consents/data-processing | accepted: true |
Organization KYB Flow
Step-by-step business verification for organization (B2B) customers:
| Step | Endpoint | Payload Highlights |
|---|
| 1. Initiate | POST /verifications | type: "BUSINESS_VERIFICATION", customerId |
| 2. Upload Cert | POST /verifications/{id}/documents | documentType: "CERTIFICATE_OF_INCORPORATION" |
| 3. Upload Address | POST /verifications/{id}/documents | documentType: "PROOF_OF_REGISTERED_ADDRESS" |
| 4. Approve | POST /verifications/{id}/approve | Admin reviews and approves |
| 5. Terms | POST /customer/organization/{id}/consents/terms | accepted: true |
| 6. Privacy | POST /customer/organization/{id}/consents/privacy | accepted: true |
| 7. Data Processing | POST /customer/organization/{id}/consents/data-processing | accepted: true |
Verification Types
| Type | Use Case | Customer Type |
|---|
IDENTITY_VERIFICATION | KYC — passport or national ID verification | Individual (B2C) |
DOCUMENT_VERIFICATION | Proof of address or supplementary documents | Individual (B2C) |
BUSINESS_VERIFICATION | KYB — corporate entity and UBO verification | Organization (B2B) |
