About | Join | Sign in

Who Called Us

The phone is ringing, and I don't recognize the number,
All Caller ID says is, "NAME UNAVAILABLE".
Please help me figure out who is calling and what they want

about

whocalled.us is collaborative caller ID, useful for finding out who called and what they want. It was the first of its kind, released back in 2005.

publicity

whocalled.us has never been pushed. This includes through ads, spam, press release, blog tip off, etc.
That means the knowledge of its existence is spread entirely through search engines and voluntary word of mouth.

privacy

All information kept is shared on the website except for a few personal details of member accounts such as password and email/phone.
If you post info about a number under investigation you may be contacted by government investigators to help the case.

scripts

OSX
NCID and Growl CallerID by David LaPorte (added 05/14/2010)
Brekeke
Automatically Block Unwanted Calls by Mitu (added 08/11/2009)
Asterisk
junk_submit by Ben Holt (updated 02/15/2008)
junk_lookup by Maxim Samo (updated 02/12/2008)
FreePBX
freepbx-utils by Rahul (updated 12/26/2008)

interface

Warning: The programming interface is untested and will be changed. This info is released for the experimental developers and is not ready for production use.

All actions require name/pass/phoneNumber and return success=0&errorMsg=Some message or success=1

http://whocalled.us/do?action=

report

At least one, either callerID, or identity must be included, preferrably both.

comment getWho

Returns who=Some name (most reported name by unique IP addresses)

getScore

Returns score=12 (number of reports by unique IP addresses)

Examples:

Report a call
do?action=report&name=test&pass=test&phoneNumber=5551234567&date=2007-03-06&callerID=800%20Service&identity=TeleCon&postalCode=90210

Comment/annotate call
do?action=comment&name=test&pass=test&phoneNumber=5551234567&message=Test