Error Codes

Code	Status	Description
`200`	OK	Request succeeded.
`202`	Accepted	Batch job submitted and is being processed.
`400`	Bad Request	Missing or invalid parameters.
`401`	Unauthorized	Invalid or missing API key.
`402`	Payment Required	Insufficient API credits for the requested service.
`404`	Not Found	The requested resource was not found (e.g., batch ID).
`500`	Internal Server Error	An unexpected error occurred on the server.

401 — Invalid API Key

Cause: The api_key parameter is missing or does not match any registered user account.Resolution: Double-check your API key from the ProWebLook dashboard and ensure it is passed correctly as a query parameter or body field.

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

402 — Insufficient Credits

Cause: Your credit balance for the requested service has been depleted.Resolution: Top up your credits from the ProWebLook dashboard. Use the Balance API to check your current balance before bulk operations.

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

400 — Missing Parameters

Cause: A required parameter is missing from the request.Resolution: Check the endpoint documentation and ensure all required fields are present.

{ "error": "PhoneNumber is missing in the request." }

400 — Batch Size Exceeded

Cause: More than 1,000 phone numbers were submitted in a single batch request.Resolution: Split your list into batches of 1,000 or fewer.

{
  "error": "Batch size exceeds the maximum allowed limit of 1000 numbers.",
  "submitted": 1500,
  "max_allowed": 1000
}

404 — Batch Not Found

Cause: The batch_id does not exist or does not belong to the provided API key.Resolution: Ensure you are polling with the same api_key that submitted the batch, and that the batch_id is correct.

{ "error": "Batch not found or access denied." }

400 — Invalid Scraping Format

Cause: One or more values in the formats array are not supported by the Scraping API.Resolution: Use only valid formats: markdown, html, rawHtml, links, metadata, screenshot.

{ "status": false, "error": "Invalid format(s): pdf, docx. Allowed: markdown, html, rawHtml, links, metadata, screenshot" }

400 — Invalid Scraping URL

Cause: The url field is missing or is not a valid http/https URL.Resolution: Ensure your url starts with http:// or https:// and is a well-formed URL.

{ "status": false, "error": "url must be a valid http or https URL" }

500 — Scraping Upstream Error

Cause: The upstream scraping service returned an error (e.g., the target site is unreachable or timed out).Resolution: Retry the request once. If it persists, check that the target URL is reachable, or increase the timeout value.

{ "status": false, "error": "Scraping failed" }

Get Started

HTTP Status Codes

Error Response Format

Common Errors

​HTTP Status Codes

​Error Response Format

​Common Errors

HTTP Status Codes

Error Response Format

Common Errors