Businesses
The Businesses API provides read and write access to all business listings in the Directory. Each business represents a supplier or service provider with details including contact information, location, categories, verification status, and more.
Read endpoints require businesses.read. Write endpoints require businesses.write.
Available Endpoints
GET
/v1/businessesList businesses with pagination and filters
businesses.read
GET
/v1/businesses/:idGet full business detail by UUID
businesses.read
GET
/v1/businesses/slug/:slugGet business by URL slug
businesses.read
GET
/v1/businesses/:id/productsList products for a business
businesses.read
GET
/v1/businesses/:id/performanceSupplier performance metrics
businesses.read
GET
/v1/businesses/:id/capabilitiesSupplier capabilities
businesses.read
GET
/v1/businesses/:id/assetsBusiness documents and files
businesses.read
POST
/v1/businessesCreate a new business listing
businesses.write
PUT
/v1/businesses/:idUpdate an existing business
businesses.write
POST
/v1/businesses/:id/performanceSubmit supplier performance feedback
businesses.write
Business Data Model
| Field | Type | Description |
|---|---|---|
id | uuid | Unique identifier |
name | string | Business name |
slug | string | URL-friendly identifier |
description | string | Business description |
address | string | Physical address |
phone | string | Phone number |
email | string | Email address |
website | string | Website URL |
whatsapp_number | string | WhatsApp number |
verified | boolean | Verification status |
featured | boolean | Featured listing |
category_id | uuid | Primary category |
region_id | uuid | Region location |
country_id | uuid | Country |
images | string[] | Image URLs |
year_established | integer | Year business was founded |
employee_count_range | string | Employee count range (e.g., "50-100") |
certifications | string[] | Business certifications |
data_quality_score | integer | Data completeness score (0-100) |
Last updated on February 23, 2026