​
Investor Lookup

Use lookup endpoints to resolve existing investor records before or after account operations. Lookup requests are protected and require idempotency.

​
Universal lookup

GET /v1/lookup searches across investor categories. Exactly one lookup strategy is required:
StrategyQuery fields
BVNbvn
CHNchn
CSCS numbercscsNo
Bank accountbankAccountNumber and bankSortCode
BVN lookup excludes dependant or minor matches. To discover minors under a guardian BVN, use the dependant-by-guardian endpoint.

​
Category lookup

Use category endpoints when the investor category is known: 
GET /v1/investors/retail
GET /v1/investors/dependants
GET /v1/investors/dependants/by-guardian
GET /v1/investors/corporate

​
Credit behavior

A credit reservation is required before lookup processing begins. Credits are charged only when matching investor records are found. Misses, validation errors, and failed requests do not charge lookup credits.