Documentation
Status Code
The following list of HTTP codes are returned by Piloterr.
The following list of HTTP status codes is returned by Piloterr. Each status code indicates the outcome of an API call and suggests a potential resolution for errors.
Status Code | Is Billed? | Explanation | Resolution |
---|---|---|---|
200 | Yes | Successful API Call | No action required. |
400 | No | Bad Request / Inactive API Key / Expired API Key | Verify your parameters and their types. Ensure your API key is active and not expired. Check the detailed error message in the response body for more information. |
401 | No | Unauthorized / Invalid API Key | Check your API key and ensure it is valid. |
402 | No | Payment Required / You Have Open Invoices | Settle any outstanding invoices to continue using the API. |
403 | No | Forbidden / Account Deactivated | Verify your permissions. Contact us if you believe this is a mistake. |
404 | Yes* | Not Found / URL Not Found | Ensure the endpoint URL is correct. This is billed except for specific endpoints listed below. |
429 | No | Rate Limit Exceeded | Consider upgrading your current plan or get in touch with our sales team. |
500 | No | Unexpected Error | Retry the action and check the detailed error message in the response body for more insights. |
Note on 404 Errors
404 errors are not billed for the following endpoints:
/api/v2/company
/api/v2/company/suggest
/api/v2/company/social
/api/v2/linkedin/company/info
Additional Notes
- 400 Bad Request: This status indicates that the server cannot process the request due to a client error (e.g., malformed request syntax or invalid parameters).
- 401 Unauthorized: Typically returned when an invalid API key is used. Make sure your API key is active and not expired.
- 402 Payment Required: Occurs if there are outstanding invoices. Settle any open invoices to continue using the API.
- 403 Forbidden: Indicates that the user does not have permission to access the requested resource.
- 429 Too Many Requests: This status indicates that the client has sent too many requests in a given amount of time (rate limiting).
- 500 Internal Server Error: This is a generic error message for unexpected server issues. Check logs for more detailed information.
Was this page helpful?