Error catalog
This page lists all responses with an error. Each row gives the cause and
the action.
How to read an error
| Response |
Format |
| Result of an operation |
HTTP 200, {"successful": false, "message": "..."} |
| Access error, format error |
HTTP 401 or 400, {"message": "...", "code": 401, "result": "error"} |
If message ends with code and a number, use the number. Do not use the
rest of the text: it can change.
{"successful": false, "message": "Exception while trying to buy object, code 2023"}
Codes in message
| Code |
Cause |
Action |
| 2006 |
The service ID is not a subscription, for example a tariff for a single video |
Use a subscription service ID from your MEGOGO manager |
| 2009 |
The subscription is not for sale |
Tell your MEGOGO manager |
| 2010 |
The subscription is not found |
Tell your MEGOGO manager |
| 2012 |
The settings of the subscription or the tariff are not correct |
Tell your MEGOGO manager |
| 2013 |
The subscription is not available in the region |
Tell your MEGOGO manager |
| 2016 |
MEGOGO cannot create the service of the user |
Retry later. If the error stays, tell MEGOGO support |
| 2023 |
The subscription is already active and the service has automatic renewal (subscribe, resume). Or the end date would be more than 15 years from now |
No action is necessary |
| 40009 |
The subscription is not sold through partners |
Tell your MEGOGO manager |
Messages without a code
message |
Request |
Cause |
Action |
User doesn't not exist |
user/phone |
The phone number is not registered in MEGOGO. The text is as the API gives it |
No action is necessary. subscribe creates the user |
Invalid phone number format |
user/phone |
The phone number has characters that are not digits |
Send only digits, with an optional + at the start |
General error |
subscriptions, subscription/{operation} |
The phone number has characters that are not digits, or another error |
Check the phone number. If the error stays, tell MEGOGO support |
Service is not configured for this partner |
subscription/{operation} |
The service ID is not configured for your partner ID |
Use a service ID from your MEGOGO manager |
Invalid operation passed |
subscription/{operation} |
The operation is not subscribe, unsubscribe, suspend or resume |
Correct the URL |
HTTP errors
| HTTP status |
Body |
Cause |
Action |
| 400 |
{"message": "Invalid request format", "code": 400, "result": "error"} |
A required parameter is not in the request, or it is empty |
Add the parameter |
| 401 |
{"message": "Not Authorized", "code": 401, "result": "error"} |
The signature is not correct or not in the request. Or the partner ID or the public key is not known. Or the IP address is not in the list of your partner ID |
See Troubleshooting |
| 429 |
— |
More than 1000 requests per minute for your partner ID |
Send fewer requests |
| 5xx, timeout |
— |
Temporary problem |
See Retries |
Successful responses that need attention
| Response |
Meaning |
unsubscribe or suspend: "successful": true |
Also when the subscription is not active. Use subscriptions to check the state |
resume: "successful": true without a suspended subscription |
resume worked as subscribe: it added a period or started a subscription |
subscriptions with a phone number: [] |
The user has no active services. If the number was not registered, the request created the user |
Guide version 1.0.0, 2026-11-02 · Report a problem on this page