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 RequestRequired parameter is missing, or Invalid parameter or Search query yield no result
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
LinkupUnknownErrorAnything else