What will you build with Okra?

Find out what you can build with Okra’s API through our documentation, SDKs and sample use cases.

Quickstart Guides

Learn more about Okra and integrate with your web or mobile app through our libraries & SDKs.

Get Started
UI frame

API Documentation

The Okra documentation is your guide for all things development.

Read the documentation
UI frame

Okra Apps

A no-code option to integrate and customise Okra with your apps.

Link with Okra Widget
UI frame

Selfie Verification

Verify identity ownership and unlock access to your digital services

Enhance identity validation and ensure your customer is who they say they are — by allowing them to take a selfie photo you can pass on to the Okra Widget, this will, in turn, validate it against their biometric photo ID.

Significantly reduce the possibility of fraud by confirming the person using your product is the account owner at the validated bank.

Selfie Verification via Libraries & SDKs

Add options to enable any of our SDKs. Click here to view SDK integration docs

Verifying biometric identity via your widget is pretty simple. Just add selfie and any of the optional nodes to your widget options as below:

const options = {
        ... {other widget options} ... 
        selfie: true,
        allowSelfieUpload: true // allow customer to upload an image to compare

The completed process will display the flow below:

Selfie Verification via our API

curl -X POST https://api.okra.ng/v2/identity/selfie/process
-H 'Content-Type: application/json' 
-H 'Authorization: Bearer <secretKey>'
-d '{
    photo: Multipart Data, // required
    identityType: "bvn" // bvn or nuban or Okra customer
    identityNumber: "123456789" // bvn or nuban or Okra customer ID
    "status": "success",
    "message": "Identity and Selfie succesfully verified",
    "data": {
        "identity": {
                "_id": "5ea1812477c7700382b20edc",
                "aliases": [
                    "GAVIN THEADORE BELSON",
                    "GAVIN BELSON",
                "phone": [
                "email": [
                    "[email protected].com"
                "verified": true,
                "next_of_kins": [],
                "address": [
                    "123 Main St. San Francisco, Calidronia"
                "owner": [
                        "_id": "5d9288ea182d3d000cb7c486",
                        "name": "Okra Tech Inc.",
                        "app_name": "Okra, Inc"
                "record": [
                        "_id": "5fc65a0fad30601d8c67affb",
                        "status": {
                            "transactions": {
                                "last_success_at": null,
                                "last_fail_at": null
                            "process": {
                                "running": false,
                                "completed": true
                        "owner": "5d9288ea182d3d000cb7c486"
                "bvn": "12345678989",
                "firstname": "GAVIN",
                "lastname": "BELSON",
                "fullname": "GAVIN BELSON",
                "customer": {
                    "_id": "5e93bad841850d3a5315f32b",
                    "name": "GAVIN BELSON"
                "env": "production",
                "photo_id": [
                        "_id": "5eaffd51f61c0e7bccf68c2d",
                        "url": "URL TO PHOTO"
                "created_at": "2020-04-23T11:51:00.286Z",
                "last_updated": "2020-12-21T17:45:25.908Z",
                "__v": 1,
                "dob": '1978-09-29',
                "gender": 'M',
                "marital_status": 'Single',
                "middlename": null

Updated about a month ago

What's Next

Learn how Debit to Credit Score works

Debit-to-Credit Score

Selfie Verification

Verify identity ownership and unlock access to your digital services

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.