# Preview expected payment eligibility `POST /api/v1/plans/{id}/subscription-impact` Estimates which linked subscriptions would receive expected payments. The preview can account for a proposed plan end date. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Plans → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `id` (integer, required) — ID of the plan. ## Body parameters - `plan_end` (integer or date string) — End of the plan, as Unix seconds or an ISO date. - `use_season_dates` (boolean) — Use September 1 and August 31 of the current sports season for the plan dates. - `update_linked_subscriptions_dates` (boolean) — Apply changed plan dates to linked subscriptions. Defaults to false. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/plans/${ID:?Set ID}/subscription-impact" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --header "Content-Type: application/json" \ --data '{"plan_end":"2027-08-31","update_linked_subscriptions_dates":true}' ``` ## Response **200 OK** Returns the total subscriptions, the eligible active subscriptions, and the number skipped because they already have expected payments. Example with fictional data and selected fields. ```json { "status": "success", "data": { "plan_id": 13, "subscription_count": 4, "eligible_subscriptions_count": 2, "skipped_subscriptions_count": 1 } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found.