MediaOS uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, etc .), and codes in the 5xx range indicate an error with Subscription Genius's servers.
| Code | Type | Description |
|---|---|---|
| 200 | OK | The request completed and a response body is provided. |
| 204 | No Content | The request completed and the response body is empty. |
| 403 | Forbidden | Invalid API credentials were supplied. |
| 404 | Not Found | The requested resource doesn't exist. |
| 405 | Method not allowed | The request method is not available on the API endpoint. |
| 500 | Server Error | Something didn't go right on Subscription Genius's end. |
Error responses will be provided in the format requested JSON.
{ "error":"{subscriber_id} is a required field" }