I tried 6 numbers of friends and only one returned a result. Are many numbers not callerid-able, or is the api just bogged down?
Hi there. So, I'm the author of this article. Anyhow, for our free-tier users we don't provide realtime lookups. Basically, we'll only return a result if we have a caller ID in our cache. So, if you get a 404 (no output), then try again a few seconds later after we've had time to do the lookup via our backend. Sorry about that! Realtime lookups are currently restricted to API key users only.
HTTP code 202 Accepted seems appropriate for this (http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)