Returns the Plans that can be used to top up this Subscription (same network provider and same coverage). Pass one of them as planID with type: TOP_UP to POST /v2/orders.
GET
/subscriptions/{subscriptionID}/compatible-plans
curl \
--request GET 'https://zim.api.zimconnections.com/subscriptions/subs_BiPtvfzYKwcyNMNvTGmLO/compatible-plans' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "X-App-Identifier: $API_KEY"
Response examples (200)
[
{
"id": "plan_guaGulGcrqgTYboPvetgu",
"name": "France - 10GB - 14 days",
"scope": "LOCAL",
"category": "REGULAR",
"type": "DATA",
"isRecurring": false,
"recurringInterval": "DAILY",
"destination": {
"name": "United Kingdom",
"isoAlpha3": "GBR",
"regions": [
{
"name": "Europe",
"abbreviation": "EU"
}
],
"scopes": {
"local": true,
"regional": true,
"global": true
}
},
"region": {
"name": "Europe",
"abbreviation": "EU"
},
"dataUnit": "GB",
"dataValue": 10,
"callUnit": "MINUTES",
"callValue": 100,
"smsUnit": "SMS",
"smsValue": 100,
"durationUnit": "DAYS",
"durationValue": 14,
"features": [
{
"name": "HOTSPOT",
"category": "UTILITY"
}
],
"prices": [
{
"currencyISO": "usd",
"value": 490,
"minorUnitsExponent": 2,
"discountedFrom": 590
}
],
"createdAt": "2026-05-04T09:42:00Z"
}
]
Response examples (401)
{
"statusCode": 401,
"message": "Unauthorized"
}
Response examples (404)
{
"statusCode": 404,
"message": "Record not found",
"error": "Not Found"
}