Common API Error Codes

This document contains common API error codes and what each code typically means in DocStudio.

Code
Error
When it happens

400

Bad request

Request data is invalid or doesn’t match the API docs. The response can include a detailed issue description.

401

Unauthorized

Auth token is invalid, incorrect, or expired.

402

Payment Required

Billing denies functionality due to missing payment or plan restrictions.

403

Forbidden

The caller doesn’t have access or permissions for the requested entity. The response can include a detailed issue description.

404

Not found

The requested entity doesn’t exist or was deleted (hard delete).

409

Conflict

Rare. Appears when two entities conflict. Usually retried, so users don’t see it.

410

Entity gone

The requested entity was deleted (soft delete). Example: a template was deleted while being processed.

422

Unprocessable entity

The requested entity can’t be processed. Example: approve/reject the same envelope twice.

425

Too early

The request was sent too early. Example: the endpoint enforces a minimum time period between requests.

429

Too many requests

Too many requests were sent to the endpoint and you exceeded the rate limits.

Last updated