API v1

Build on Malaysia's scam database.

Integrate PenipuMY scam data into your apps, bots and workflows with a simple REST API.

Overview

Query Malaysia's community-driven scam database from your own apps, bots and workflows: phone numbers, bank accounts, social profiles and more. Every lookup is a simple GET that returns JSON; batch screening is one POST.

Base URLhttps://api.penipu.my/v1/

Authentication

Send your API key in the X-API-Key header with every request. Create a key in Account settings.

X-API-Key: pmyv1_…

Keep your key secret. Don't put it in client-side code or public repositories; call the API from your server.

Rate limits and pricing

Effective 14 September 2026.

Free100 requests a dayFree
Starter10,000 requests a monthRM59/mo
Business50,000 requests a monthRM199/mo
Enterprise500,000 requests a monthRM999/mo

Need a top-up? Bonus quota: +5,000 requests for RM30, one time.

The free tier resets at midnight Malaysia time (UTC+8). Paid tiers reset on your billing date. Every response tells you where you stand:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87

The free tier is for academic, research, educational and development use, or any product that's free to its end users. See the API terms.

Profile details

GET/v1/profile/{profile_id}

Everything on one scam profile, including all linked reports.

Parameters

NameTypeDescription
profile_idrequiredstringThe profile_id from a search result, for example pid-abc123. Part of the path.

Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.penipu.my/v1/profile/pid-abc123"

Response 200 OK

{
  "profile_id": "pid-abc123",
  "name": "Suspect Name",
  "total_reports": 5,
  "total_loss_myr": 25000.0,
  "asset_counts": {
    "bank_accounts": 2,
    "phone_numbers": 3,
    "social_accounts": 1
  },
  "platforms_involved": [
    "Instagram",
    "TikTok"
  ],
  "reports": [
    {
      "report_id": 42,
      "public_token": "aB3dEfGhIjKlMnOp",
      "url": "https://penipu.my/report/view/aB3dEfGhIjKlMnOp",
      "status": "VERIFIED",
      "amount_lost_myr": 5000.0,
      "submitted_at": "2026-01-15 09:30:00"
    }
  ],
  "created_at": "2025-06-01 10:00:00",
  "last_updated": "2026-02-28 12:00:00"
}

Phone lookup

GET/v1/phone

Quick check on one phone number: police reports, community reports, spam and fraud flags, and the business behind it if it's a verified number.

Parameters

NameTypeDescription
qrequiredstringPhone number, 8 to 15 digits. Accepts +60, 60 or 0 prefixes.

Response fields

  • phoneNormalised phone number
  • police_report_countPDRM reports, via SemakMule
  • police_report_statuslive, cached, cached_stale, queued or unavailable. See PDRM checks
  • verified_report_countVerified community reports
  • unverified_report_countPublished community reports not yet verified
  • profile_idThe scam profile this number belongs to, or null
  • riskRisk level, score and reasons. See Risk score
  • spamFlagged as spam by caller ID
  • fraudFlagged as fraud
  • businessBusiness directory match, or null for unknown numbers. tier is verified, verified_spoofing, compromised or free; spoofing_report_count appears when the tier is verified_spoofing. opening_hours_status is computed in Malaysia time.

Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.penipu.my/v1/phone?q=0312345678"

Response 200 OK

{
  "phone": "0312345678",
  "police_report_count": 0,
  "police_report_status": "live",
  "verified_report_count": 0,
  "spam": false,
  "fraud": false,
  "business": {
    "tier": "verified",
    "brand_slug": "bank-saujana",
    "brand_name": "Bank Saujana",
    "branch_slug": "klcc",
    "branch_name": "KLCC",
    "display_name": "Bank Saujana - KLCC",
    "is_ambiguous": false,
    "logo_url": "https://penipu.my/uploads/logo_example.png",
    "website": "https://example.com",
    "place_url": "https://www.google.com/maps/place/...",
    "address": "Lot G45, Kuala Lumpur",
    "rating": 4.2,
    "review_count": 186,
    "opening_hours_status": "Open · Closes 12 am",
    "wheelchair_accessible": true,
    "scam_alert_banner": null
  }
}

Bank account lookup

GET/v1/bank

Quick check on one bank account: police and community report counts.

Parameters

NameTypeDescription
qrequiredstringAccount number, 6 to 24 digits. Spaces and hyphens are removed for you.

Response fields

  • bank_accountNormalised, digits only
  • holder_nameAccount holder name from reports, or null. Initials only for institutional accounts
  • bank_nameBank name from reports, or null
  • police_report_countPDRM reports, via SemakMule
  • police_report_statuslive, cached, cached_stale, queued or unavailable
  • verified_report_countVerified community reports
  • unverified_report_countPublished community reports not yet verified
  • bnm_alerttrue when the linked profile is on BNM's Financial Consumer Alert List
  • profile_idThe scam profile this account belongs to, or null
  • fraudtrue when verified reports exist
  • riskRisk level, score and reasons. See Risk score

Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.penipu.my/v1/bank?q=1234567890"

Response 200 OK

{
  "bank_account": "1234567890",
  "holder_name": "MOHD FAIZAL BIN RAHMAN",
  "bank_name": "Bank Saujana Berhad",
  "police_report_count": 2,
  "police_report_status": "cached",
  "verified_report_count": 1,
  "unverified_report_count": 0,
  "bnm_alert": false,
  "profile_id": "pid-abc123",
  "fraud": true,
  "risk": {
    "level": "HIGH",
    "score": 80,
    "reasons": [
      { "code": "verified_reports", "text": "1 verified community report", "source": "community", "points": 50 },
      { "code": "police_reports", "text": "2 police reports on PDRM SemakMule", "source": "pdrm", "points": 30 }
    ]
  }
}

Name screening

GET/v1/entity

Institutional accounts only. Screen a person or company name against scam profiles that have a published report or a BNM listing, and the account holder names recorded on them. Words such as bin, binti, a/l, a/p and Sdn Bhd are ignored when comparing.

Parameters

NameTypeDescription
qrequiredstringFull name of the person or company, 3 to 100 characters.

Response fields

  • matchesUp to 10 profiles, strongest match first
  • matchexact (same words, same order), strong (same words in another order, or nearly the same spelling) or partial (every word you sent appears)
  • matched_onprofile_name or account_holder
  • matched_nameThe name that matched. Initials only for account holders on institutional accounts
  • profileProfile summary, as in Search
  • bnm_alerttrue when the profile is on BNM's alert list
  • riskThe profile's risk. See Risk score

A name match is a lead, not proof: different people share names. Confirm with the account number or phone number before acting.

Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.penipu.my/v1/entity?q=Mohd%20Faizal%20bin%20Rahman"

Response 200 OK

{
  "query": "Mohd Faizal bin Rahman",
  "count": 1,
  "matches": [{
    "match": "exact",
    "matched_on": "account_holder",
    "matched_name": "M••• F••• B••• R•••",
    "profile": { "profile_id": "pid-abc123", "total_reports": 3, … },
    "bnm_alert": false,
    "risk": { "level": "HIGH", "score": 75, … }
  }]
}

Batch screening

POST/v1/screen

Institutional accounts only. Screen up to 100 bank accounts, phone numbers and names in one call, for example every beneficiary in a payout run. Each item counts as one request against your quota.

Body (JSON)

NameTypeDescription
itemsrequiredarray1 to 100 objects, each with type (bank, phone or name) and value (text).

Response fields

  • resultsOne entry per item, in the order sent, with index, type and value
  • resultThe same answer as the single bank, phone or name lookup
  • errorInstead of result when that item was invalid

Batch screening reads police counts from our cache only and never asks PDRM while you wait. Numbers we haven't checked recently come back as queued; ask again later for the count. See PDRM checks.

Request

curl -X POST -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"type": "bank", "value": "1234567890"}, {"type": "name", "value": "Orion Jaya Trading"}]}' \
  "https://api.penipu.my/v1/screen"

Response 200 OK

{
  "count": 2,
  "results": [
    { "index": 0, "type": "bank", "value": "1234567890",
      "result": { "risk": { "level": "MEDIUM", … }, … } },
    { "index": 1, "type": "name", "value": "Orion Jaya Trading",
      "result": { "count": 0, "matches": [] } }
  ]
}

Statistics

GET/v1/stats

Platform-wide numbers.

No parameters.

Request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.penipu.my/v1/stats"

Response 200 OK

{
  "total_profiles": 1234,
  "total_reports": 5678,
  "verified_reports": 3456,
  "total_loss_myr": 2500000.0,
  "total_bank_accounts_tracked": 890,
  "total_phone_numbers_tracked": 1200,
  "total_social_accounts_tracked": 450
}

Risk score

Bank, phone and name answers carry risk: a level, a score from 0 to 100 and the reasons behind it. Every reason names its source and the points it adds, so you can apply your own rules instead of ours.

  • verified_reports50 points for the first, 10 more for each after, up to 70. Source community
  • unverified_reports15 points for the first, 5 more for each after, up to 25. Source community
  • police_reports30 points, or 40 from 3 reports. Source pdrm
  • bnm_alert40 points. Source bnm
  • caller_id_fraud20 points, phones with no police reports only (a police report sets the same flag). Source caller_id
  • caller_id_spam10 points, phones only. Source caller_id
  • business_compromised30 points, phones only. Source directory
  • verified_business0 points, for information. Source directory
  • business_spoofed0 points, for information. Source directory
  • police_check_queued0 points, for information. Source pdrm
  • police_check_unavailable0 points, for information. Source pdrm

The score is the sum, capped at 100. Levels: HIGH from 70, MEDIUM from 40, LOW from 1, NONE at 0. NONE means we hold nothing against it, not that it's safe.

Sandbox

Make a test key (it starts pmyv1_test_) on the API tab of Account settings. Test keys answer every endpoint from the invented sample data below, never touch real reports or PDRM, use none of your plan, and allow 1,000 requests a day. Answers carry "sandbox": true.

TryValueYou get
Bank999900000001HIGH: verified reports and police reports, holder MOHD FAIZAL BIN RAHMAN
Bank999900000002MEDIUM: police reports only
Bank999900000003LOW: one unverified community report
Bank999900000004NONE, with the police check queued
Bank999900000005NONE: nothing on record
Bank999900000006HIGH: profile on BNM's alert list
Phone0199990001HIGH: verified reports and police reports
Phone0199990002MEDIUM: police reports and spam flag
Phone0199990003LOW: Caller ID fraud and spam flags
Phone0199990004NONE: verified business
Phone0199990005NONE: nothing on record
NameMohd Faizal bin Rahman, Faizal Rahman, Mega Prima Capital GroupExact, partial and BNM-listed matches

Data sources and institutions

What the answers are built from:

  • communityScam reports sent by PenipuMY members. Our team reviews them; ones with enough evidence are marked verified. Reports waiting for review are never counted.
  • pdrmThe number of police reports on PDRM's public SemakMule check. We don't hold the reports themselves. Answers are cached for 24 hours.
  • bnmBNM's Financial Consumer Alert List, synced from Bank Negara Malaysia.
  • caller_idFraud and spam flags on phone numbers, from at least three different community members or from a police report.
  • directoryBusinesses listed and verified in the PenipuMY directory.

PDRM checks. A single lookup on a standard account asks PDRM live when our answer is older than 24 hours. Batch screening and institutional accounts never wait on PDRM: they get our cached answer (cached or cached_stale), and anything missing is checked in the background and comes back as queued until then. Each account can queue 500 new numbers a day.

Institutional accounts (banks, payment and remittance companies) get account holder names as initials, cache-only PDRM checks on every endpoint, and name screening and batch screening (other accounts get 403 on /v1/entity and /v1/screen; test keys answer everyone with sample data). Email [email protected] to set one up, ask for volumes above Enterprise, or request our data sheet and terms for business clients.

PenipuMY is a community platform, not an official or regulated data source. Use our answers as one signal in your own screening, not as the only one.

Errors

Errors use standard HTTP status codes and a JSON body with an error message.

StatusMeaningWhat to do
400Bad requestA parameter is missing or invalid.
401UnauthorizedThe API key is missing or invalid.
403ForbiddenThe key is paused for review or needs a paid plan. The body says which.
404Not foundThe profile doesn't exist.
429Too many requestsYou've hit your limit. Free tier and test keys reset at midnight MYT. A batch that doesn't fit in what's left is refused whole.
500Server errorSomething went wrong on our side. Try again shortly.

Example error body

{
  "error": "Query parameter \"q\" is required (3-100 characters)."
}

Ready to build?

Create a free account and generate your first API key in a minute.

Get an API key