Skip to content

Problem types

Problem types

Every error answer of the API points with type at one of these pages. Each names the cause, the way out and an example answer.

Branch on code in your client. Title and explanation come in the language of your Accept-Language, the code stays the same.

30 problem types
StatusCodeTitle
400INVALID_REQUESTInvalid request
400BATCH_TOO_LARGEBatch too large
400CURSOR_MISMATCHCursor does not match the request
400UNKNOWN_PARAMETERUnknown parameter
401UNAUTHENTICATEDNot authenticated
403FORBIDDENForbidden
403RISK_FAMILY_BLOCKEDRisk family blocked
403ORGANIZATION_MISMATCHOrganization mismatch
403API_MODULE_DISABLEDPublic API not enabled
404NOT_FOUNDNot found
404OPERATION_NOT_IN_VERSIONOperation not available in this version
409IDEMPOTENCY_IN_PROGRESSRequest with this Idempotency-Key still in progress
409UPLOAD_INCOMPLETEUpload incomplete
409WEBHOOK_ENDPOINT_LIMIT_REACHEDToo many webhook endpoints
410VERSION_SUNSETAPI version shut down
412PRECONDITION_FAILEDPrecondition failed
422VALIDATION_FAILEDValidation failed
422IDEMPOTENCY_PAYLOAD_MISMATCHIdempotency-Key used with a different payload
422UPLOAD_CHECKSUM_MISMATCHUpload checksum mismatch
422UPLOAD_REJECTEDFile rejected
422BATCH_FAMILY_NOT_ALLOWEDFamily not allowed in a batch
422WEBHOOK_URL_INVALIDInvalid webhook URL
428PRECONDITION_REQUIREDPrecondition required
429RATE_LIMITEDToo many requests
429OVERLOADEDInstance overloaded
429QUOTA_EXHAUSTEDQuota exhausted
500INTERNALInternal error
502UPSTREAMUpstream service error
503API_PAUSEDAPI paused
503INSTANCE_PENDINGInstance is being updated