Skip to main content
This guide includes an overview of error codes you might see from both the API and our SDKs.

​
API Errors

Whatever the HTTP error code is, the response payload will contain the following object: statusCode: number - HTTP error code. error: object - Linkup error details containing:
  • code: string - Error name
  • message: string - Description of the error
  • details: array - Details of the error. This array may be empty or include objects with the following properties:
    • field: string - The field that caused the error
    • message: string - A description of the field error
Here is an example: 
{
	"statusCode": 400,
	"error": {
		"code": "VALIDATION_ERROR",
		"message": "Validation failed",
		"details": [
			{
				"field": "outputType",
				"message": "outputType must be one of the following values: sourcedAnswer, searchResults, structured"
			}
		]
	}
}
API Error Codes
CodePossible Reasons
400 - Bad Request
  • Required parameter is missing
  • Invalid parameter
  • Search query yields no result
  • Fetch request targets a web page > 20MB
  • Fetch request targets a file
401 - UnauthorizedAPI Key is missing or invalid
403 - ForbiddenAPI key does not have permission to access this resource
409 - ConflictResource conflict (e.g., duplicate entry or conflicting request)
429 - Too Many RequestsYou have run out of credit or you are sending too many concurrent requests
500 - Internal Server ErrorSomething’s up on our end

​
SDK Errors

Python & JS SDK Error Types
TypeReason
LinkupInvalidRequestErrorRequired parameter is missing, or invalid parameter
LinkupNoResultErrorSearch query yield no result
LinkupAuthenticationErrorAPI Key is missing, invalid or you do not have permission to access this ressource
LinkupInsufficientCreditErrorYou have run out of credit
LinkupTooManyRequestsErrorYou are sending too many concurrent requests
LinkupFetchErrorThe provided URL might not be found or can’t be fetched
LinkupFetchResponseTooLargeErrorThe provided URL’s response is too large to be processed (>20MB)
LinkupFetchUrlIsFileErrorThe provided URL points to a file and not a web page
LinkupUnknownErrorAnything else