Mpowered API Introduction

Mpowered provides a suite of APIs that allow you to integrate directly with three of our core platforms:

• BEEtoolkit – a full B-BBEE management system covering all scorecard pillars.
  • Get started with the BEEtoolkit API Reference →
• Supplier Management System (SMS) – a dedicated procurement engine focused on supplier data, procurement scorecards, and verification-ready spend processing.
  • Get started with the SMS API Reference →
• Beagle Database – a company and B-BBEE scorecard lookup API, including signed scorecard document downloads.
  • Get started with the Beagle Database API Reference →

These APIs are designed for organisations that need automated, repeatable, and reliable ways to synchronise supplier data, load procurement transactions, manage B-BBEE scorecards programmatically, and retrieve external scorecard records.

What You Can Do With the API​

The API enables you to:

1. Manage Supplier Master Data​

Create and maintain your supplier list using your own vendor codes. Attributes can include VAT numbers, intragroup status, contact details, B-BBEE-related flags, and more.

2. Build Procurement Scorecards​

Create scorecards for any period—month, year-to-date, or financial year—using your chosen B-BBEE charter. Scorecards can be published and marked as canonical for a given period.

3. Load Procurement Spend​

Record procurement transactions using Line Items, which form the basis of:

• Total Measured Procurement Spend (TMPS)
• Recognition calculations
• B-BBEE procurement points
• Supplier Development alignment

Line items are append-only to preserve auditability.

4. Search Companies and External Scorecards​

Use Beagle Database to search for companies by VAT number, registration number, or ID number, and retrieve associated B-BBEE scorecards.

5. Download Scorecard Documents​

Generate time-limited, signed download links for underlying scorecard documents from Beagle Database.

6. Retrieve Verification-Ready Data​

All data is stored and processed using verification-aligned rules. This means the API lets you pull clean, structured, compliant data into your internal BI tools or ERP systems.

How Authentication Works​

Authentication depends on the platform:

• BEEtoolkit and Supplier Management System (SMS) use:
  • X-Api-Key – your account key
  • HMAC Signature – a request-specific signature proving call integrity
• Beagle Database uses:
  • HTTP Basic Authentication – your web app username and password

See each platform's Authentication section for implementation details.

Base URLs​

Use the base URL for the platform you are integrating with:

• BEEtoolkit: https://www.beetoolkit.co.za
• Supplier Management System (SMS): https://www.suppliermanagement.co.za
• Beagle Database: https://www.beagledatabase.co.za