API Responses

Status Codes

The table below summarizes the HTTP response codes returned from the Primer REST API.

PropertyValue
200Success
400Bad Request
401Unauthorized
403Forbidden
404Entity Not Found
422Input Validation Failed
429Too Many Requests

Error Responses

Artlist uses standard HTTP response codes to indicate the success or failure of API requests. Codes in the 2XX range indicate a success, while codes in the 4XX range indicate a failure, typically due to invalid inputs or operations. The error payload format is consistent for all errors. In the event of an unsuccessful, the payload will follow this structure:

1{
2 "success": false,
3 "error": {
4 "message": "Not found",
5 "code": 1,
6 "status": 404
7 },
8}