Errors

Handle API errors with RFC 7807 problem details, HTTP status codes, and validation error responses

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"
  ]
}