Skip to main content
MasterID is a live, workspace-scoped API for identity and business verification, wallet balance checks, and mobile money collections in Uganda. This guide covers the v1 public API surface so you can build secure backend integrations that verify subjects, collect payments, and receive real-time completion events.

​
What you can do

Identity and business verifications

Verify national IDs, TINs, bank accounts, CRB records, business registrations, KCCA licences, AML/PEP status, and phone numbers.

Verification results

Request consent wording, submit checks, poll for results, and retrieve formatted outcomes with charge details.

Wallet balance

Check your workspace wallet balance in UGX before submitting charged operations.

Mobile money collections

Request payments from MTN or Airtel subscribers and track collection status through the API.

Webhooks

Receive signed completion events for verifications and collections, and validate delivery with HMAC signatures.

​
Key facts

  • Base URL: https://masterid.me/api/public/v1
  • API version: v1
  • Currency: UGX
  • Environments: Live only. There is no sandbox in this release.
  • Document version: 1.0 (released 18 October 2026)

​
How integration works

  1. You generate a credential pair in the Developer Console and store both values securely.
  2. You call GET /catalog to list supported products, required fields, and prices.
  3. Before each verification, you request consent wording from POST /verifications/consent, present it to the data subject, and confirm it when submitting.
  4. You submit the check with an Idempotency-Key and store the returned sessionId.
  5. You poll GET /verifications/{sessionId} or accept a signed verification.completed webhook.
  6. For mobile money collections, you complete merchant activation, then create and track collection requests.

​
Next steps

Quickstart

Run your first catalog, consent, and verification flow in minutes.

Authentication

Learn how to send credentials, rotate keys safely, and troubleshoot 401/403 responses.

Guides

Walk through verifications, payment collection, webhooks, and the go-live checklist.

API reference

Browse endpoint details for catalog, wallet, verifications, collections, and webhooks.

​
Support

If you need help, contact MasterID support at sales@masterid.co.ug or call +256 771 922 513.