Verify a business address

curl -X POST "https://api.dojah.io/api/v1/kyc/address/business" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme Stores Ltd",
    "business_mobile": "08011112222",
    "first_name": "John",
    "last_name": "Musa",
    "mobile": "08012345678",
    "street": "270 Murtala Muhammed Way, Yaba",
    "lga": "Lagos Mainland",
    "city": "Lagos",
    "state": "Lagos"
  }'

const res = await fetch("https://api.dojah.io/api/v1/kyc/address/business", {
  method: "POST",
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    business_name: "Acme Stores Ltd",
    business_mobile: "08011112222",
    first_name: "John",
    last_name: "Musa",
    mobile: "08012345678",
    street: "270 Murtala Muhammed Way, Yaba",
    lga: "Lagos Mainland",
    city: "Lagos",
    state: "Lagos"
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.dojah.io/api/v1/kyc/address/business",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    json={
        "business_name": "Acme Stores Ltd",
        "business_mobile": "08011112222",
        "first_name": "John",
        "last_name": "Musa",
        "mobile": "08012345678",
        "street": "270 Murtala Muhammed Way, Yaba",
        "lga": "Lagos Mainland",
        "city": "Lagos",
        "state": "Lagos"
    },
)
data = res.json()

{
  "entity": {
    "status": "pending",
    "reference_id": "69e10264-4b90-64fe-b4b7-c9dddafd0241"
  }
}

POST/api/v1/kyc/address/business

Submit a business name, its contact and the owner’s details for physical verification of the company address in Nigeria. Like the individual check, it’s asynchronous — submit returns a reference_id you poll for the result.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.
`Content-Type`	Yes	`application/json`

Body parameters

Parameter	Type	Required	Description
`business_name`	string	Yes	Name of the business.
`business_mobile`	string	Yes	Office mobile number of the business.
`first_name`	string	Yes	First name of the business owner.
`last_name`	string	Yes	Last name of the business owner.
`mobile`	string	Yes	Mobile number of the business owner.
`street`	string	Yes	House number and street name of the business.
`landmark`	string	No	Closest landmark to the location.
`lga`	string	Yes	Local Government Area.
`city`	string	Yes	City.
`state`	string	Yes	State.

Response

The submit call returns an entity with status: "pending" and a reference_id. Keep the reference_id to retrieve the result.

Fetch verification results

Business submissions are polled the same way as individual ones — call GET /api/v1/kyc/address with the reference_id returned above. The result entity carries the same shape (applicant/contact, captured location and photos, a neighbour reference and agent comments); see Individual Address → Fetch verification results for the full response.

GET /api/v1/kyc/address

curl "https://api.dojah.io/api/v1/kyc/address?reference_id=69e10264-4b90-64fe-b4b7-c9dddafd0241" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

Errors

Code	Meaning
`400`	Bad request — a required field is missing or malformed.
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`429`	Too many requests — back off and retry.

curl -X POST "https://api.dojah.io/api/v1/kyc/address/business" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Acme Stores Ltd",
    "business_mobile": "08011112222",
    "first_name": "John",
    "last_name": "Musa",
    "mobile": "08012345678",
    "street": "270 Murtala Muhammed Way, Yaba",
    "lga": "Lagos Mainland",
    "city": "Lagos",
    "state": "Lagos"
  }'

const res = await fetch("https://api.dojah.io/api/v1/kyc/address/business", {
  method: "POST",
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    business_name: "Acme Stores Ltd",
    business_mobile: "08011112222",
    first_name: "John",
    last_name: "Musa",
    mobile: "08012345678",
    street: "270 Murtala Muhammed Way, Yaba",
    lga: "Lagos Mainland",
    city: "Lagos",
    state: "Lagos"
  }),
});
const data = await res.json();

import os, requests

res = requests.post(
    "https://api.dojah.io/api/v1/kyc/address/business",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
    json={
        "business_name": "Acme Stores Ltd",
        "business_mobile": "08011112222",
        "first_name": "John",
        "last_name": "Musa",
        "mobile": "08012345678",
        "street": "270 Murtala Muhammed Way, Yaba",
        "lga": "Lagos Mainland",
        "city": "Lagos",
        "state": "Lagos"
    },
)
data = res.json()

{
  "entity": {
    "status": "pending",
    "reference_id": "69e10264-4b90-64fe-b4b7-c9dddafd0241"
  }
}

Get started

Core concepts

API Endpoints

Widget SDKs

API clients

Verify a business address

Headers

Body parameters

Response

Fetch verification results

Errors

​Headers

​Body parameters

​Response

​Fetch verification results

​Errors

Headers

Body parameters

Response

Fetch verification results

Errors