Skip to main content
ClickTerm uses standard HTTP status codes to indicate the success or failure of an API request.

​
Error codes

CodeMeaningDescriptionHow to fix
400Bad RequestYour request is invalid. Details are included in the response body.Check the message field in the response for the specific validation error
401UnauthorizedYour App ID or App Key is incorrect.Verify X-APP-ID and X-APP-KEY headers. See Authentication
403ForbiddenYou are not allowed to access this resource.Check that your integration is linked to the template in the Dashboard
404Not FoundThe specified App ID is not valid or the template could not be found.Ensure the template is Enabled with an Effective version
405Method Not AllowedYou used an HTTP method not supported by this endpoint.Use POST for /clickwrap/verify, GET for all other endpoints
406Not AcceptableYou requested a format that isn’t JSON.Set Accept: application/json or omit the header
409ConflictYou are trying to create a resource that already exists.The Signature has already been verified — each is single-use
429Too Many RequestsRate limit exceeded.Wait for the duration in the Retry-After header. See Rate Limits
500Internal Server ErrorSomething went wrong on our end.Retry once, then contact support if it persists
503Service UnavailableWe’re temporarily offline for maintenance.Retry after the Retry-After header duration

​
Error response format

Error responses include a message describing the issue: 
{
  "message": "The clicktermSignature field is required."
}

​
Common issues

​
401 Unauthorized

  • Verify your App ID and App Key are correct
  • Check that you’re using headers (X-APP-ID, X-APP-KEY), not query parameters
  • If you recently regenerated the App Key, make sure your backend is using the new one

​
404 Not Found

  • The template may not be Enabled in the dashboard
  • The template may not have an Effective version (check that effectiveAt has passed)
  • The App ID may not be linked to the template

​
400 Bad Request

  • The clicktermSignature field is missing or malformed in the verify request
  • A required parameter is missing from the request
For SDK-specific errors (Web and Android), see the SDK Error Reference.