Error catalog¶
All error codes of the Content API and the Billing API, with the action for each code. For problems that have no code, see Troubleshooting.
How MEGOGO reports an error¶
| Interface | Format |
|---|---|
| Content API | Most errors: HTTP 200 with "result": "error", code and message. A wrong signature: HTTP 400 |
Content API, /stream |
The user cannot watch: HTTP 200, "result": "ok", an empty src and the restrictions array |
| Billing API | HTTP 200 with "successful": false. The code is at the end of message: "…, code 2023" |
| Billing API, access | HTTP 401 with a plain text, not JSON |
Do not use only the HTTP status: read the body. Do not show message to
the user: the text is not fixed and can be in English.
Retry in the tables: "Yes" means that the same request can be
successful later. Wait 1 minute between the attempts and make a maximum
of 6 attempts. Before you retry subscribe or buyMovie, check the
services of the user with user/subscriptions: these requests are not
idempotent.
Content API¶
HTTP status / code |
Meaning | Retry | Action |
|---|---|---|---|
HTTP 400, "You entered wrong sign key" |
The signature is not correct, or the public key is not known | No | Check the order and the values of the parameters. See Sign a request |
| HTTP 406, empty body | The path of the request is not correct | No | Make sure that the URL starts with https://api.megogo.net/v1/ |
"code": 400 |
A parameter is not correct or not in the request | No | Read the reference of the request |
"code": 403 |
The access token is not correct or expired | No | Get a new access token with /auth/refresh or /auth/by_partners |
"code": 404 |
The video is not found | No | Remove the video from your catalog |
| HTTP 429 | More than 1000 requests per minute with this key | Yes | Send fewer requests. Cache the responses. See Operations |
| HTTP 5xx, timeout | Temporary problem | Yes | Send the request again |
Playback restrictions (/stream)¶
/stream gives these codes in restrictions[].code when src is empty.
/video/info can give the same codes. MEGOGO can add new codes: if you do
not know a code, tell the user that the video is not available.
| Code | Meaning | Action |
|---|---|---|
NOT_PURCHASABLE |
The user has no subscription or purchase for this video, or the request has no access_token |
Offer a subscription or a purchase. Check the services with user/subscriptions |
NO_VOD_COUNTRY, NOT_ENABLED_IN_COUNTRY |
The video is not available in the country of the user | Tell the user. Do not show the video in this country |
CONTRACT, NO_CONTRACT |
The video is not in your contract | Remove the video from your catalog |
BIZ_CLASS |
The video is not available for the platform of your key | Do not show the video on this platform. See Platforms and rights |
NO_BITRATE |
No quality is available for your key, for example a 4K version on a key without the 4K setting | Do not show 4K versions without the 4K setting |
BITRATE_DISABLED_BY_PURCHASED_SUBSCRIPTION |
The service of the user does not include this quality, for example an SD tariff | Offer a service with this quality |
UHD_IS_NOT_SUPPORTED, HDR_IS_NOT_SUPPORTED, D3_IS_NOT_SUPPORTED |
The key does not support 4K, HDR or 3D | Do not show these versions on this key |
DRM, NO_DRM_SUPPORT |
The video has DRM, but your key does not support it | Ask your MEGOGO manager about the DRM settings of the key |
PARTNER_IS_DISABLED |
Your partner account is disabled | Contact your MEGOGO manager |
NO_SCHEDULE_FOR_CHANNEL, INVALID_VIRTUAL_OBJECT_ID, CATCH_UP_IS_UNAVAILABLE |
Codes for TV channels and catch-up. This guide does not describe them | — |
Billing API¶
| Code | Name | Meaning | Retry | Action |
|---|---|---|---|---|
| HTTP 401 | — | The IP address of the server is not in your list, or the partner ID is not correct | No | Send the request from a server of your list. A new address works some minutes after the change |
| 400 | — | The request cannot be done, for example buyMovie for a video that the user already bought |
No | Check user/subscriptions |
| 2009 | SUBSCRIPTION_NOT_SELLING | The subscription is not for sale | No | Tell MEGOGO support |
| 2010 | SUBSCRIPTION_NOT_FOUND | The subscription is not found | No | Check the service ID. Tell MEGOGO support |
| 2012 | INVALID_PERMISSIONS | The settings of the subscription or the tariff are not correct | No | Tell MEGOGO support |
| 2013 | SUBSCRIPTION_NOT_GEO_PRESENTED | The subscription is not available in the region | No | Tell MEGOGO support |
| 2015 | OBJECT_NO_VOD_PERMISSION_FOR_SALE | The video has no delivery rule for sale | No | Do not offer the purchase. Check /video/info |
| 2016 | USER_SERVICE_CREATION_ERROR | MEGOGO cannot create the service of the user | Yes | Check user/subscriptions, then retry. If it fails again, tell MEGOGO support |
| 2017 | USER_SERVICE_NOT_FOUND | The service of the partner is not found | No | Check the service ID. Tell MEGOGO support |
| 2022 | TARIFF_ID_DOESNT_MATCH_ORDER_SERVICE_ID | The tariff ID is not a tariff of this service | No | Use tariff_id from /video/info |
| 2023 | PROLONGATION_DISABLED | The service is already active (subscribe or resume) |
No | No action is necessary |
| 2027 | DATE_FINISH_OUT_OF_BOUNDS | The end date would be more than 5 years from now | No | Do not renew now |
| 2029 | VOD_RULES_NOT_FOUND_FOR_OBJECT | The video has no delivery rules | No | Remove the offer. Check /video/info |
| 2031 | SUBSCRIPTION_QUALITY_FOR_OBJECT_NOT_FOUND | This quality of the video is not in the service | No | Use another tariff from /video/info |
| 4001 | OBJECT_PREVIOUSLY_PURCHASED | The user already bought this video | No | No action is necessary |
| 4003 | PARTNER_NOT_FOUND | The partner is not found | No | Check the partner ID in the URL |
| 5001 | USER_NOT_FOUND | The user is not found | No | Check the user identifier. For a new user, send subscribe, buyMovie or user/create first |
| 40416 | — | The service ID or the tariff ID is not found for your partner ID | No | Use the service IDs from MEGOGO and tariff_id from /video/info |
| 42901 | error.too_many_requests | Too many requests: more than 1000 requests per minute for your partner ID | Yes | Send fewer requests |
| HTTP 5xx, timeout | — | Temporary problem | Yes | Check user/subscriptions, then retry |
When you contact support¶
Send to supportpartners@megogo.net: your partner ID, the request without keys and tokens, the response, and the time of the request in UTC.
Guide version 1.4.1, 2026-10-31 · Report a problem on this page