Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.verifow.com/llms.txt

Use this file to discover all available pages before exploring further.

All endpoints are prefixed with /api/v1/ and require Authorization: Bearer <token> except login.

Base URL

/v1

Endpoints by Module

Authentication

EndpointMethodsDescription
/auth/loginPOSTAuthenticate and receive tokens
/auth/refreshPOSTRefresh access token
/auth/meGETCurrent user profile
/auth/usersPOST, GETCreate or list users
/auth/users/:idPATCH, DELETEUpdate or deactivate user
/auth/api-keysPOST, GETCreate or list API keys

Transactions

EndpointMethodsDescription
/transactions/screenPOSTScreen a transaction
/transactionsGETList transactions
/transactions/:idGETGet transaction details

Cases

EndpointMethodsDescription
/casesPOST, GETCreate or list cases
/cases/:idGETGet case details
/cases/:id/statusPATCHUpdate case status
/cases/:id/assignPATCHAssign case to user
/cases/:id/notesPOSTAdd note to case

Rules

EndpointMethodsDescription
/rulesPOST, GETCreate or list rules
/rules/:idGET, PATCH, DELETEGet, update, or delete rule
/rules/:id/activatePATCHActivate a rule
/rules/:id/pausePATCHPause a rule

KYC

EndpointMethodsDescription
/kyc/applicationsPOST, GETSubmit or list applications
/kyc/applications/:idGETGet application details
/kyc/applications/:id/verify-bvnPOSTVerify BVN
/kyc/applications/:id/verify-ninPOSTVerify NIN
/kyc/applications/:id/liveness-checkPOSTRun liveness check
/kyc/applications/:id/approvePATCHApprove application
/kyc/applications/:id/rejectPATCHReject application

KYB

EndpointMethodsDescription
/kyc/kyb/applicationsPOST, GETCreate or list KYB applications
/kyc/kyb/applications/:idGETGet KYB application details
/kyc/kyb/applications/:id/verify-cacPOSTRun CAC lookup by RC number
/kyc/kyb/applications/:id/verify-directorsPOSTVerify all directors via KYC
/kyc/kyb/applications/:id/screen-beneficial-ownersPOSTScreen BOs against sanctions
/kyc/kyb/applications/:id/approvePATCHApprove KYB application
/kyc/kyb/applications/:id/rejectPATCHReject KYB application

Tenant Configuration

EndpointMethodsDescription
/tenants/meGET, PATCHGet or update tenant config (incl. KYC provider mode)

Reports

EndpointMethodsDescription
/reports/sarPOSTGenerate SAR
/reports/ctrPOSTGenerate CTR
/reports/ftrPOSTGenerate FTR
/reportsGETList reports
/reports/:idGETGet report details
/reports/:id/xmlGETDownload report XML
/reports/:id/approvePATCHApprove report
/reports/:id/filePATCHMark report as filed

Audit

EndpointMethodsDescription
/audit/eventsGETQuery audit logs
/audit/verifyGETVerify audit chain integrity

System

EndpointMethodsDescription
/healthGETHealth check (no auth required)
/engines/healthGETEngine health status

HTTP Status Codes

CodeMeaningWhen It Happens
200OKRequest succeeded
201CreatedResource created successfully
204No ContentResource deleted or deactivated
400Bad RequestValidation error — check request body
401UnauthorizedMissing or invalid token
403ForbiddenInsufficient permissions for this action
404Not FoundResource does not exist
409ConflictDuplicate or conflicting state
429Too Many RequestsRate limit exceeded
500Server ErrorUnexpected error — retry with backoff

Verifow — Enterprise-grade AML/CFT compliance for African financial institutions.