Quickstart

Make your first Dojah verification in a few minutes. Grab your keys, call a sandbox endpoint with test data, then swap in your live keys when you’re ready to go live.

1. Get your API keys

Every request is authenticated with two values from your dashboard under Developers → Configuration:

Credential	Header	Where to use it
App ID	`AppId`	Identifies your app on every request.
Secret key	`Authorization`	Server-side only. Sent raw — not as `Bearer`.
Public key	—	Client-side / widget only (see hosted flows).

Keep your secret key server-side. Never ship it in web or mobile code — use the public key with the widget for anything client-facing.

2. Make your first call

Sandbox is free and returns predictable mock data, so you can build end-to-end without spending credits. This looks up a Nigerian NIN using the sandbox test value 70123456789:

cURL

curl "https://sandbox.dojah.io/api/v1/kyc/nin?nin=70123456789" \
  -H "AppId: {{app_id}}" \
  -H "Authorization: {{secret_key}}"

A successful response wraps the result in an entity object:

JSON

{
  "entity": {
    "first_name": "JOHN",
    "last_name": "DOE",
    "gender": "m",
    "date_of_birth": "1990-01-01"
  }
}

See Sandbox & test data for every test value (BVN, OTP, bank account and more), and Browse the API for the full endpoint list.

If you’d rather not build request flows yourself, drop in the hosted widget and let Dojah handle the UI, capture and verification steps:

HTML

<script src="https://widget.dojah.io/widget.js"></script>
<script>
  const connect = new Connect({
    app_id: "{{app_id}}",
    p_key: "{{public_key}}",
    type: "verification",
    config: { widget_id: "{{widget_id}}" },
    onSuccess: (data) => console.log(data),
  });
  connect.setup();
  connect.open();
</script>

The script tag takes no async/defer. Full options and callbacks are on Launch a flow.

Next steps

Environments — sandbox vs production and the go-live checklist.
Authentication — headers, keys and common 401s.
Sandbox & test data — every value you can test with.
Errors & status codes — including 402 and 424.

Get started

Core concepts

API Endpoints

Widget SDKs

API clients

1. Get your API keys

2. Make your first call

3. Prefer no code? Use the widget

Next steps

​1. Get your API keys

​2. Make your first call

​3. Prefer no code? Use the widget

​Next steps

1. Get your API keys

2. Make your first call

3. Prefer no code? Use the widget

Next steps