Back
Developers
Skip to content
Live

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/businesses

    List 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}/reviews

    List 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-score

    Get 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/categories

    List 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/checks

    Check 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-alerts

    List 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/licences

    Search 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/me

    Get 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.

We use cookies to keep the site working, measure visits and show ads on our guides. Read our cookie policy