Finnova API Service

Welcome to Finnova's API documentation. This guide will help you integrate KYC, AML, fraud detection, credit scoring, and risk analytics into your application.

Getting Started

  1. Register for an API key via the /register page.
  2. Authenticate using your API key in the Authorization header.
  3. Send requests to the endpoints below with the required payloads.
  4. Review responses and integrate results into your workflow.

Endpoints

MethodEndpointDescription
POST/api/kyc/verifyVerify identity documents
POST/api/aml/checkAML/CFT transaction screening
POST/api/fraud/scoreFraud probability scoring
GET/api/credit-scoresRetrieve credit scores
GET/api/risk-scoresRetrieve risk scores

Authentication

Header: Authorization: Bearer <your_api_key>

Include your API key in every request for secure access.

Example Request

POST /api/kyc/verify
Authorization: Bearer <your_api_key>
Content-Type: application/json

{
  "name": "John Doe",
  "id_number": "123456789",
  "document_type": "passport",
  "document_image": "<base64>"
}

Example Response

{
  "verified": true,
  "score": 0.98,
  "details": {
    "name_match": true,
    "document_valid": true
  }
}

Error Handling

{
  "error": "Invalid API key",
  "code": 401
}

All errors are returned in JSON format with an appropriate HTTP status code.

Support & Resources