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.
https://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.
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.
Search
GET/v1/search
Search the scam database across phone numbers, bank accounts, names and social usernames.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | What to search for. Phone, bank account, name or social username. Minimum 3 characters. |
type | string | auto (default), phone, bank, social or name. |
limit | integer | Number of results. Default 10, maximum 25. |
Request
curl -H "X-API-Key: YOUR_KEY" \
"https://api.penipu.my/v1/search?q=0123456789"const res = await fetch("https://api.penipu.my/v1/search?q=0123456789", {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/search",
params={"q": "0123456789"},
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
Response 200 OK
{
"query": "0123456789",
"type": "phone",
"count": 1,
"results": [
{
"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
},
"last_updated": "2026-02-28 12:00:00"
}
]
}
Profile details
GET/v1/profile/{profile_id}
Everything on one scam profile, including all linked reports.
Parameters
| Name | Type | Description |
|---|---|---|
profile_idrequired | string | The 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"const res = await fetch("https://api.penipu.my/v1/profile/pid-abc123", {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/profile/pid-abc123",
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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
| Name | Type | Description |
|---|---|---|
qrequired | string | Phone number, 8 to 15 digits. Accepts +60, 60 or 0 prefixes. |
Response fields
phoneNormalised phone numberpolice_report_countPDRM reports, via SemakMulepolice_report_statuslive,cached,cached_stale,queuedorunavailable. See PDRM checksverified_report_countVerified community reportsunverified_report_countPublished community reports not yet verifiedprofile_idThe scam profile this number belongs to, ornullriskRisk level, score and reasons. See Risk scorespamFlagged as spam by caller IDfraudFlagged as fraudbusinessBusiness directory match, ornullfor unknown numbers.tierisverified,verified_spoofing,compromisedorfree;spoofing_report_countappears when the tier isverified_spoofing.opening_hours_statusis computed in Malaysia time.
Request
curl -H "X-API-Key: YOUR_KEY" \
"https://api.penipu.my/v1/phone?q=0312345678"const res = await fetch("https://api.penipu.my/v1/phone?q=0312345678", {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/phone",
params={"q": "0312345678"},
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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
| Name | Type | Description |
|---|---|---|
qrequired | string | Account number, 6 to 24 digits. Spaces and hyphens are removed for you. |
Response fields
bank_accountNormalised, digits onlyholder_nameAccount holder name from reports, ornull. Initials only for institutional accountsbank_nameBank name from reports, ornullpolice_report_countPDRM reports, via SemakMulepolice_report_statuslive,cached,cached_stale,queuedorunavailableverified_report_countVerified community reportsunverified_report_countPublished community reports not yet verifiedbnm_alerttruewhen the linked profile is on BNM's Financial Consumer Alert Listprofile_idThe scam profile this account belongs to, ornullfraudtruewhen verified reports existriskRisk level, score and reasons. See Risk score
Request
curl -H "X-API-Key: YOUR_KEY" \
"https://api.penipu.my/v1/bank?q=1234567890"const res = await fetch("https://api.penipu.my/v1/bank?q=1234567890", {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/bank",
params={"q": "1234567890"},
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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
| Name | Type | Description |
|---|---|---|
qrequired | string | Full name of the person or company, 3 to 100 characters. |
Response fields
matchesUp to 10 profiles, strongest match firstmatchexact(same words, same order),strong(same words in another order, or nearly the same spelling) orpartial(every word you sent appears)matched_onprofile_nameoraccount_holdermatched_nameThe name that matched. Initials only for account holders on institutional accountsprofileProfile summary, as in Searchbnm_alerttruewhen the profile is on BNM's alert listriskThe 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"const res = await fetch("https://api.penipu.my/v1/entity?q=" + encodeURIComponent("Mohd Faizal bin Rahman"), {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/entity",
params={"q": "Mohd Faizal bin Rahman"},
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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)
| Name | Type | Description |
|---|---|---|
itemsrequired | array | 1 to 100 objects, each with type (bank, phone or name) and value (text). |
Response fields
resultsOne entry per item, in the order sent, withindex,typeandvalueresultThe same answer as the single bank, phone or name lookuperrorInstead ofresultwhen 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"const res = await fetch("https://api.penipu.my/v1/screen", {
method: "POST",
headers: { "X-API-Key": process.env.PENIPUMY_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ items: [
{ type: "bank", value: "1234567890" },
{ type: "name", value: "Orion Jaya Trading" }
] })
});
const data = await res.json();import os, requests
res = requests.post(
"https://api.penipu.my/v1/screen",
json={"items": [
{"type": "bank", "value": "1234567890"},
{"type": "name", "value": "Orion Jaya Trading"},
]},
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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"const res = await fetch("https://api.penipu.my/v1/stats", {
headers: { "X-API-Key": process.env.PENIPUMY_KEY }
});
const data = await res.json();import os, requests
res = requests.get(
"https://api.penipu.my/v1/stats",
headers={"X-API-Key": os.environ["PENIPUMY_KEY"]},
)
data = res.json()
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. Sourcecommunityunverified_reports15 points for the first, 5 more for each after, up to 25. Sourcecommunitypolice_reports30 points, or 40 from 3 reports. Sourcepdrmbnm_alert40 points. Sourcebnmcaller_id_fraud20 points, phones with no police reports only (a police report sets the same flag). Sourcecaller_idcaller_id_spam10 points, phones only. Sourcecaller_idbusiness_compromised30 points, phones only. Sourcedirectoryverified_business0 points, for information. Sourcedirectorybusiness_spoofed0 points, for information. Sourcedirectorypolice_check_queued0 points, for information. Sourcepdrmpolice_check_unavailable0 points, for information. Sourcepdrm
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.
| Try | Value | You get |
|---|---|---|
| Bank | 999900000001 | HIGH: verified reports and police reports, holder MOHD FAIZAL BIN RAHMAN |
| Bank | 999900000002 | MEDIUM: police reports only |
| Bank | 999900000003 | LOW: one unverified community report |
| Bank | 999900000004 | NONE, with the police check queued |
| Bank | 999900000005 | NONE: nothing on record |
| Bank | 999900000006 | HIGH: profile on BNM's alert list |
| Phone | 0199990001 | HIGH: verified reports and police reports |
| Phone | 0199990002 | MEDIUM: police reports and spam flag |
| Phone | 0199990003 | LOW: Caller ID fraud and spam flags |
| Phone | 0199990004 | NONE: verified business |
| Phone | 0199990005 | NONE: nothing on record |
| Name | Mohd Faizal bin Rahman, Faizal Rahman, Mega Prima Capital Group | Exact, 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.
| Status | Meaning | What to do |
|---|---|---|
400 | Bad request | A parameter is missing or invalid. |
401 | Unauthorized | The API key is missing or invalid. |
403 | Forbidden | The key is paused for review or needs a paid plan. The body says which. |
404 | Not found | The profile doesn't exist. |
429 | Too many requests | You'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. |
500 | Server error | Something 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.