ZapSign API
English
English
  • General Information
  • Getting Started
  • ZapSign Environments
  • Ready-to-use requests!
  • Authentication
    • Static token
    • JWT Authentication
      • Get access token
      • Refresh your access token
  • Types of Tokens
  • API versioning
  • Rate Limit Policies
  • Incident alerts
  • How Payment Works
  • Status Code
  • Account
    • Plan Information
    • List account users
    • Create account users
    • Delete account user
  • Documents
    • Create document via Upload
    • OneClick (ClickWrap)
      • Create document (OneClick)
    • Create document via Template
    • Add attachment (extra document)
    • Add attachment (extra document) via Template
    • Detail document
    • List documents
    • Delete document
    • Document Audit Trail
    • Optional: Place signatures
    • Reject Documents
  • Signers
    • Detail signer
    • Update signer
    • Add signer
    • Delete signer
    • Batch sign via API
    • Reject Documents by User
  • Templates
    • Create template (DOCX)
      • Configure Template Form
    • List templates
    • Get template
    • Update template
    • Delete template
  • Partnerships
    • Update Payment Status
    • Create Account
  • TIMESTAMP
    • Add timestamp
  • Background Check
  • Introduction
  • Understanding the Result
  • Creating a Background Check
    • Person Check
    • Company check
  • Retrieve a Check
  • Check details
  • Webhooks
    • How webhooks works
    • Testing webhooks on ZapSign
    • Create Webhook
    • Webhooks logs
    • Events
      • Document
        • Doc created
        • Doc deleted
        • Created signer
      • Signer
        • Signature request send
        • Document viewed
        • Reading confirmation
        • Doc signed
        • Doc refused
        • Email bounce
        • Failed Validation
      • Background check
        • Background check completed
    • Reprocessing Documents and Webhooks
    • Delete Webhook
  • Widget
    • How widget works
Powered by GitBook
On this page

Was this helpful?

Status Code

ZapSign uses standard HTTP status codes. 4xx errors occur when there is an issue with the request sent by the client to ZapSign, while 5xx errors indicate potential server problems

PreviousHow Payment WorksNextPlan Information

Last updated 8 months ago

Was this helpful?

Our application always returns a 200 status code for successful responses. Below, we outline the common errors that may occur and how to address them:

Code
Reference
Explanation

400

BAD REQUEST

ZapSign processes all requests in JSON, so formatting errors such as missing commas, malformed base64, etc., can cause this error.

401

UNAUTHORIZED

The server did not authorize the request. Your may be incorrect.

402

PAYMENT REQUIRED

The client does not have an API plan. In the production environment, it is mandatory to have a monthly plan to use the API. Navigate to Settings > Plans and Pricing or

403

FORBIDDEN

The server did not authorize the request. Check if the API token used corresponds to the environment you want to use.

404

NOT FOUND

The server could not find the resource or is unwilling to disclose its existence. Check the URL used or the template ID if you are using Templates.

406

NOT ACCEPTABLE

Check if you are sending your request in JSON format. Remember to verify strings and booleans throughout the body

429

TOO MANY REQUESTS

The client has exceeded the allowed request limit within a specific time period.

Access Token
click here.