Skip to main content
HomeDevelopers

Developer Portal

Dashboard
Back to Tutorials
BeginnerCompaniesB-BBEESupplier IntelligenceCIDB

Company Intelligence — Supplier Profiles and B-BBEE Data

Look up any supplier company in South Africa's government procurement ecosystem. Access B-BBEE levels, award history, CIDB grading, and compliance scores.

3 stepsBeginner

Prerequisites

  • A valid Tenders-SA API key
  • Basic knowledge of REST APIs
1

Search for a company

Use the companies/search endpoint to find a supplier by name. Results include B-BBEE level, enterprise type, total awards, and total value.
curl
curl -H "Authorization: Bearer tsa_prod_YOUR_API_KEY" \  "https://api.tenders-sa.org/v1/companies/search?q=TechSol&enterpriseType=QSE"

Expected response:

JSON
{  "success": true,  "data": [    {      "name": "TechSol SA (Pty) Ltd",      "enterpriseType": "QSE",      "beeLevel": "Level 2",      "totalAwards": 42,      "totalValue": 95000000,      "categories": ["ICT & Technology", "Infrastructure"],      "provinces": ["Gauteng", "Western Cape"]    }  ]}
2

Get the full company profile

Retrieve the complete company profile including registration details, CIDB grading, compliance score, directors, and contact information.
curl
curl -H "Authorization: Bearer tsa_prod_YOUR_API_KEY" \  "https://api.tenders-sa.org/v1/companies/TechSol%20SA%20(Pty)%20Ltd"

Expected response:

JSON
{  "success": true,  "data": {    "name": "TechSol SA (Pty) Ltd",    "registrationNumber": "2020/123456/07",    "enterpriseType": "QSE",    "beeLevel": "Level 2",    "cidbGrading": "8CE PE",    "totalAwards": 42,    "totalValue": 95000000,    "complianceScore": 85,    "forensicRiskScore": 12,    "directors": [      { "name": "John Doe" },      { "name": "Jane Smith" }    ],    "contactEmail": "[email protected]",    "awards": [      { "amount": 9500000, "tenderTitle": "ICT Infrastructure", "tenderProvince": "Gauteng" }    ]  }}
3

Use company data for bid decisions

Compare CIDB grading against tender requirements, verify B-BBEE level for preferential procurement points, and check compliance scores before bidding.
JavaScript
const API = 'https://api.tenders-sa.org/v1'const KEY = 'tsa_prod_YOUR_API_KEY' async function assessCompany(name) {  const res = await fetch(`${API}/companies/${encodeURIComponent(name)}`, {    headers: { 'Authorization': `Bearer ${KEY}` }  })  const { data: company } = await res.json()   console.log(`Company: ${company.name}`)  console.log(`B-BBEE Level: ${company.beeLevel}`)  console.log(`CIDB Grading: ${company.cidbGrading || 'Not rated'}`)  console.log(`Compliance Score: ${company.complianceScore}/100`)  console.log(`Total Awards: ${company.totalAwards}`)  console.log(`Active in: ${company.provinces.join(', ')}`)   // Check if CIDB grading meets a typical tender requirement  const requiredGrade = '8CE'  if (company.cidbGrading?.startsWith(requiredGrade)) {    console.log('✅ Meets CIDB grade 8 requirement')  }} assessCompany('TechSol SA (Pty) Ltd')