Informal Business Verification

This feature enables the verification of information about an informal business.

To determine if a business exists, we use the IDU Code, Owner Identity Document Number, or Owner Phone Number to calculate a match score between owner and business information. By setting a scoring threshold, we can assess the existence of a business.

Verify Informal Business Information

POST /verification/informal-business

Headers:

  • Api-Key (required): provided by Danaya

  • Api-Secret (required): provided by Danaya

  • Content-Type (required): application/json

here you have to provide this informal business informations to verify:

{
  "iduCode": "string",
  "ownerIdentityDocumentNumber": "string",
  "phoneNumber": "string", // 
  "ownerBirthDate": "string", REQUIRED // Format yyyy-mm-dd
  "ownerBirthPlace": "string",  REQUIRED
  "activityMunicipality": "string",  REQUIRED // e.g: Cocody
  "ownerFullName": "string"  REQUIRED
}

Responses:

For each of the values provided in the request body, we will give you a matching score ranging from 0 to 100.

  • OK:

    • Code: 200

    • Body

    {
      "iduCode": "string",
      "ownerBirthDateScore": 100,
      "ownerBirthPlaceScore": 53,
      "ownerNameScore": 100,
      "activityMunicipalityScore": 100,
      "isValid": false,
      "threshold": 80 // to be defined by the clients
     }
  • Code : 401

TBD

  • Code: 400

TBD

Last updated