Status Codes

All API responses include an HTTP status code indicating the result of the request.

Success

Code	Description
200	OK - Request succeeded. Response body contains the requested data.

Code	Description
400	Bad Request - Invalid or missing parameters. Check the error message for details.
401	Unauthorized - Missing or invalid API key. Ensure `X-INFOPLUG-API-KEY` header is set.
402	Payment Required - Insufficient credits. Top up your account to continue.
404	Not Found - The requested resource does not exist (e.g., profile, company, or job not found).
429	Too Many Requests - Rate limit exceeded. Wait before making more requests.

Code	Description
500	Internal Server Error - Something went wrong on our end. Try again later.
503	Service Unavailable - Temporary failure or timeout. Retry the request.

All error responses include a JSON body with details:

{
  "message": "invalid_parameter",
  "parameter": "linkedin_url",
  "details": "Missing or invalid linkedin_url"
}

Field	Description
`message`	Error type (e.g., `invalid_parameter`, `error`, `unauthorized`)
`parameter`	The parameter that caused the error (if applicable)
`details`	Human-readable description of what went wrong

Message	Cause	Solution
`invalid_parameter`	A required parameter is missing or invalid	Check the endpoint documentation for required parameters
`payload_is_empty`	Request body is empty	Include required JSON body in POST requests
`limit_out_of_range`	Limit value is outside allowed range	Use a limit within the specified range (e.g., 1-2500)

Message	Cause	Solution
`unauthorized`	API key is missing or invalid	Add valid `X-INFOPLUG-API-KEY` header

Message	Cause	Solution
`insufficient_credits`	Account has no credits remaining	Purchase more credits at infoplug.io

Message	Cause	Solution
`not_found`	Profile, company, or job doesn't exist	Verify the URL or ID is correct

Message	Cause	Solution
`rate_limit_exceeded`	Too many requests in a short time	Implement exponential backoff and retry