Errors

The SignYu API uses standard HTTP status codes and returns a consistent JSON error body.

Error format

Every error response has the same shape: a short machine readable error code and a human readable message.

{
  "error": "insufficient_credits",
  "message": "You need 2 credits to send this document."
}

Status codes

Status	Error	Meaning
400	invalid_content_type	Document creation was not sent as multipart/form-data.
400	invalid_request	The request body failed validation. message explains what.
400	invalid_file	The uploaded file is missing, empty, or not a PDF.
400	no_signers	You tried to send a document with no signers.
400	signer_limit_reached	The document already has the maximum of 6 signers.
401	unauthorized	The API key is missing or invalid.
402	insufficient_credits	Your account does not have enough credits to send.
403	api_access_not_enabled	Your account does not have API access. Subscribe at /app/subscribe-api.
404	not_found	The document does not exist or is not owned by your account.
409	invalid_state	The action is not allowed in the document's current state, for example adding signers after it was sent.
413	file_too_large	The PDF exceeds the 10MB limit.
429	rate limited	Too many requests. Retry with backoff.
500	internal_error	Something went wrong on our side.

Handling errors

• Treat any 2xx as success and everything else as a failure.
• Use the error code for logic and show or log the message for humans.
• Retry 429 and 5xx responses with exponential backoff. Do not retry 4xx errors other than 429, since they will fail again until you fix the request.