Types of API Errors

Errors can originate from validation, authentication, authorization, resource existence, business conflicts, rate limits, dependency failures, timeouts, or unexpected server faults.

Do not expose internal stack traces, SQL statements, secrets, filesystem paths, or dependency details to clients in production.

A useful API distinguishes between errors that clients can fix and errors that require server-side intervention.

Error Categories
400: Malformed or invalid request
The request cannot be processed as submitted.
401: Authentication failure
Credentials are missing or invalid.
403: Authorization failure
The caller lacks permission.
409: Conflict
The request conflicts with current resource state.
422: Semantic validation failure
The syntax is valid but business validation fails.
500: Unexpected server error
The server encountered an unhandled failure.