Errors

A description of standard errors returnable by the API.

Proof APIs will respond with standard HTTP error codes should you make a bad request. 400 and 422 errors will have more specific messaging depending on the API and endpoint used.

HTTP Status CodeSummary
200 - SUCCESSSuccessful API request.
400 - BAD REQUESTBad request or invalid parameters.
401 - NOT AUTHENTICATEDNot authenticated.
403 - NOT AUTHORIZEDNo access to this specific feature.
404 - NOT FOUNDThe requested item does not exist.
422 - BAD REQUESTViolated business rule.
500 - SERVER ERRORUnknown error. Retry the call.

If you'd like more help deciphering errors and error codes from the Proof API, please contact Support.

Deleting Transactions

Deleting transactions via UI or API will also delete records and objects associated with the transaction.
For example, querying a transaction or attempting to fetch one or more of a transaction's documents after a successful deletion request will return a 404 response.

{
    "errors": [
        "Transaction Not Found"
    ]
}

Transaction deletion requests executed in our UI or via API will only succeed if the transaction is incomplete.
If there is an attempt to delete a transaction while the transaction is complete ( "detailed_status": "complete") the deletion request will fail and return a 422 response.

{
    "errors": [
        "Transaction has already been completed by at least 1 signer."
    ]
}