SignatureAPI uses conventional HTTP response codes to indicate the success or failure of an API request. In general:
  • Codes in the 2XX range indicate success.
  • Codes in the 4XX range indicate problems with the request, like missing parameters.
  • Codes in the 5XX range indicate problems with SignatureAPI servers.
Errors messages conform to RFC 7807 and use a Content-Type of application/problem+json.

​
General Errors

This payload is for 4XX client errors, except validation errors, and 5XX errors.
​
type
string
A URL that identifies the problem type. Visit the URL to learn more about this problem.
​
title
string
short, human-readable summary of the problem type
​
status
integer
The HTTP status code generated by the server for this occurrence of the problem
​
detail
string
A human-readable explanation specific to this occurrence of the problem.

​
Example

{
  "type": "https://signatureapi.com/docs/v1/errors/invalid-api-key",
  "title": "Invalid API Key",
  "status": 401,
  "detail": "Please provide a valid API key in the X-API-Key header."
}

​
Validation Errors

This payload is for validation errors (along a 422 status code).
​
type
string
A URL that identifies the problem type. Visit the URL to learn more about this problem.
​
title
string
short, human-readable summary of the problem type
​
status
integer
The HTTP status code generated by the server for this occurrence of the problem.For validation errors, this value is always 422.
​
errors
array of Strings
A human-readable list of specific validation errors.

​
Example

{
  "type": "https://signatureapi.com/docs/v1/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "errors": [
    "documents[0].url protocol must be HTTPS",
    "recipients[0].email must be a valid email address"
  ]
}