Business Verification

e-verify provides comprehensive business verification services by integrating with the Companies and Intellectual Property Commission (CIPC) system in South Africa. This allows you to verify company registration details, director information, and other relevant business data.

Endpoint

POST /v1/business/verify

Request Body

Field	Type	Description	Required
registration_number	string	The CIPC registration number of the business.	Yes
business_name	string	(Optional) The name of the business for additional validation.	No

Example Request

POST /v1/business/verify HTTP/1.1
Host: api.e-verify.co.za
X-API-Key: ev_live_YOUR_API_KEY
Content-Type: application/json

{
  "registration_number": "2005/012345/07",
  "business_name": "Example (Pty) Ltd"
}

Response

{
  "request_id": "req_business_1234567890",
  "status": "completed",
  "result": {
    "registration_number": "2005/012345/07",
    "business_name": "Example (Pty) Ltd",
    "status": "Active",
    "registration_date": "2005-01-15",
    "directors": [
      {
        "name": "John Doe",
        "id_number": "8001015009087"
      }
    ],
    "overall_status": "verified"
  },
  "message": "Business verification completed successfully."
}

Error Codes

Code	Description
400	Invalid input data
401	Unauthorized
403	Forbidden
404	Business not found
500	Internal server error