Developers
The TrustCheck API puts Ghana's trust data in your app: businesses and their trust scores, reviews, scam reports on phone numbers, handles and websites, official scam alerts and licence registers. Free sandbox, OpenAPI spec, Postman collection.
Endpoints
-
GET
/api/v1/businessesList and search businesses. Approved businesses on TrustCheck, best trust score first. Search by name or website, filter by category, verification or minimum score.
-
GET
/api/v1/businesses/{business}Get a business. One business: trust score and label, average rating and review count, verification, claim status, response rate and links.
-
GET
/api/v1/businesses/{business}/reviewsList a business's reviews. Published reviews, newest first, with the business's official reply. Reviewers appear as first name and initial; anonymous reviews stay anonymous.
-
GET
/api/v1/businesses/{business}/trust-scoreGet a trust score with its parts. The 100-point trust score and the five parts it is made of (rating 30, review volume 20, replies 20, verification 20, open disputes 10), with the inputs used.
-
GET
/api/v1/categoriesList categories. Business categories with the number of approved businesses in each. Use the id to filter GET /businesses.
-
GET
/api/v1/checks/{type}/{value}Check a phone number, social handle or website. What TrustCheck knows about a Ghana phone/MoMo number, an Instagram, TikTok or Facebook handle, or a website: published scam reports (count, categories, money lost, dates, what happened), official warnings that name it, and listed businesses that use it. Reporters are never identified. verdict is "reported" or "no_reports"; no reports is not proof of safety.
-
GET
/api/v1/checksCheck anything (type detected). Same as /checks/{type}/{value}, but TrustCheck works out what the text is: a phone number, a social profile link or @handle (Instagram unless you send type), or a website.
-
GET
/api/v1/scam-alertsList official scam alerts. Warnings published by regulators, the police and banks (Scam Watch), newest first, with the source link.
-
GET
/api/v1/scam-alerts/{id}Get a scam alert. One official alert by id.
-
GET
/api/v1/licencesSearch licence registers. Entries from Ghana's public licence registers (Bank of Ghana, SEC, NIC, Gaming Commission and others) and their public warning lists. status is "licensed" or "warning". Send q or regulator.
-
GET
/api/v1/licences/{slug}Get a licence holder. Every register entry for one company (a firm can hold several licences, or appear on a warning list), with licensed and warning flags.
-
GET
/api/v1/meGet the current API key. Which key you are using: its mode (live or test), plan and rate limits. Useful to test your setup.
Request example
curl https://trustcheckapp.com/api/v1/checks/phone/0200000001 \ -H "Authorization: Bearer tc_test_demo_public_sandbox_key"
Keys and limits
- Test keys (tc_test_) are free on every business account and read the sandbox. Live keys (tc_live_) read real data on the Premium plan.
- Send the key as Authorization: Bearer YOUR_KEY. Every answer is JSON with data and meta; errors have a code, a message and a request id.
- Live keys allow 120 requests a minute with no daily cap. The full guide, limits and every endpoint are in the API docs.