Skip to main content

Overview

Every request to the ProWebLook API must include a valid API key. Authentication is performed via a query parameter or request body field named api_key.
Keep your API key confidential. Do not expose it in client-side code, public repositories, or logs.

Passing Your API Key

You can pass the API key in two ways:
Append api_key as a URL query parameter:
curl "https://lookup.proweblook.com/api/v1/phonevalidation?phone_number=%2B14155552671&api_key=YOUR_API_KEY"

Error Responses

HTTP StatusCodeMeaning
401Invalid API key.The provided api_key does not match any registered user.
402Insufficient * API credits.Your credit balance for the requested service has been exhausted.
400VariousMissing or invalid parameters.

Example: Invalid API Key

{
  "error": "Invalid API key."
}

Example: Insufficient Credits

{
  "error": "Insufficient phone API credits."
}

Getting Your API Key

  1. Sign up or log in at proweblook.com
  2. Navigate to Dashboard → API Keys
  3. Copy your key and store it securely (e.g., in an environment variable)
# Best practice: use environment variables
export PROWEBLOOK_API_KEY="your_api_key_here"
curl "https://lookup.proweblook.com/api/v1/balance?service=phonevalidation&api_key=$PROWEBLOOK_API_KEY"