Newznab Error Codes

Under normal circumstances i.e. when the HTTP request/response sequence is successfully completed Newznab implementations always respond with HTTP 200 OK. However this doesn't mean that the query was semantically correct. It simply means that the HTTP part of the sequence was successful. One then must check the actual response body/data to see if the request was completed without errors.

In case of a Newznab error the response contains an error code and an a description of the error.

The error codes have been defined into different ranges. 100-199 Account/user credentials specific error codes, 200-299 API call specific error codes, 300-399 content specific error codes and finally 900-999 Other error codes.

Error code	Description
100	Incorrect user credentials
101	Account suspended
102	Insufficient privileges/not authorized
103	Registration denied
104	Registrations are closed
105	Invalid registration (Email Address Taken)
106	Invalid registration (Email Address Bad Format)
107	Registration Failed (Data error)
200	Missing parameter
201	Incorrect parameter
202	No such function. (Function not defined in this specification).
203	Function not available. (Optional function is not implemented).
300	No such item.
300	Item already exists.
900	Unknown error
910	API Disabled

Error code example

Query could not be completed because user credentials are broken

Request:

GET http://servername.com/api?t=details&apikey=xxxxx&guid=xxxxxxxxx

Response:

200 OK

Content:
```
<?xml version="1.0" encoding="UTF-8"?>
<error code="100" description="Incorrect user credentials"/>
```