Smarter Drafter uses HTTP response codes to show the status of an API request.

In general:

Codes in the 200 range mean the request was successful.
Codes in the 400 range mean the request failed with the information provided (e.g., a required parameter was not provided).
Codes in the 500 range mean there's an error with Smarter Drafter's server (which is rare).

Some 4xx errors that could be handled programmatically (e.g., the data already exists) include an error code that briefly explains the error reported.

Code	Response	Explanation
200	OK	Everything worked as expected.
400	Bad Request	The request was unacceptable, often due to missing a required parameter.
401	Unauthorised	No valid API key provided.
402	Request Failed	The parameters were valid but the request failed.
403	Forbidden	The API key doesn’t have permissions to perform the request.
404	Not Found	The requested resource doesn’t exist.
409	Conflict	The request conflicts with another request.
429	Too Many Requests	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.
500, 502, 503, 504	Server Error	Something went wrong on Smarter Drafter's end. (These are rare.)