Appearance
Sandbox Context
Use the values and rules on this page when testing against the sandbox environment. All sandbox endpoints use the base URL https://api-test.streamline.laboremus.ug.
TIN Verification
TIN numbers must be exactly 10 numeric digits. The last digit controls the outcome.
| Last digit | Outcome |
|---|---|
0 | Failed — invalid |
1 – 9 | Success — valid |
Test values
| TIN | Expected result |
|---|---|
1234567891 | Success |
1234567890 | Failure |
National ID Verification
→ National ID Verification API
The format of the NIN determines the country. The NIN must also appear in the sandbox whitelist — anything outside the whitelist returns error 320 ("Person not found").
Uganda NIN
Format: CM######XX#### or CF######XX#### — 14 alphanumeric characters.
| Prefix | Meaning |
|---|---|
CM | Male |
CF | Female |
Whitelisted Uganda NINs
Use any NIN from the sandbox whitelist. Values outside the list return error 320.
Uganda Card Number
Exactly 9 digits, e.g. 123456789.
Kenya NIN
Format: 9–10 digits only, e.g. 29708460.
INFO
Any NIN string outside the supported formats or whitelist returns: 320 — Person not found
Phone Number Verification
→ Phone Number Verification API
Phone numbers must be in one of two formats:
| Format | Example | Length |
|---|---|---|
256XXXXXXXXX | 256789123456 | 12 digits |
07XXXXXXXX | 0789123456 | 10 digits |
The last digit controls the outcome:
| Last digit | Outcome |
|---|---|
0 | Failed — invalid |
1 – 9 | Success — valid |
Network assignment by prefix
| Prefix | Network |
|---|---|
25678, 25679, 25677, 25676 | MTN |
25675, 25670, 25674 | Airtel |
Test values
| Phone number | Expected result | Network |
|---|---|---|
256789123456 | Success | MTN |
256789123450 | Failure | MTN |
MTN Data Match
For MTN requests that include a nationalIdNumber, any NIN string is accepted — no whitelist applies.
ID Document Validation
Outcome is driven by whether the front and back photos are identical.
| Condition | Outcome |
|---|---|
| Front and back have the same filename AND same file size | Declined — 7–8 document check failures + imageManipulated fraud flag |
| Front and back are different files (different name or size), or no back photo provided | Success — returns a Ugandan NATIONAL_ID result for "WAMALA SAMUEL" |
How to test
- Success: Upload two different image files (different filename or different file size) as front and back.
- Failure: Use the exact same file for both front and back.
AML / PEP Screening
Outcome is driven by keywords in the surname and givenName fields.
| Name contains | Hits | Type |
|---|---|---|
Laden (e.g. Bin Laden) | 7 | SANCTION |
Khalili | 1 | SANCTION |
Among or Anita | 1 | PEP |
| Anything else | 0 | Clean — no hits |
The option field accepts AML, PEP, or Both. Sending Both (the default) always checks both lists.
Test values
| surname | givenName | option | Expected hits | Type |
|---|---|---|---|---|
Laden | Bin | Both | 7 | SANCTION |
Khalili | (any) | Both | 1 | SANCTION |
(any) | Among | Both | 1 | PEP |
(any) | Anita | Both | 1 | PEP |
Smith | John | Both | 0 | Clean |
MTN Customer Data Match
There are no special format rules for this service in sandbox. The scoring logic is based on which fields you include or omit in the request.
| Field included in request | Score returned |
|---|---|
Any field you provide (surName, givenName, nationalIdNumber, country, phoneNumber, streetAddress) | 100 |
Fields omitted: emailAddress, streetAddress, city, postCode | -1 |
Send any valid phone number (256 prefix format). All submitted fields return a score of 100; any omitted optional fields return -1.