# Get pending downgrade for a subscription contract

Retrieves the pending/scheduled downgrade details for a specific subscription contract. This endpoint returns information about a downgrade that has been scheduled but not yet executed.

Response Information:
- contractId: The subscription contract ID
- waitTillTimestamp: When the downgrade will be executed
- oldVariantId: The current product variant ID
- newVariantId: The target product variant ID after downgrade
- oldPrice: Current subscription price
- newPrice: New price after downgrade
- sellingPlanId: The selling plan ID for the new subscription
- sellingPlanName: Name of the selling plan

Use Cases:
- Check if a customer has a pending downgrade scheduled
- Display pending downgrade information in custom dashboards
- Verify downgrade details before allowing further modifications

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

Endpoint: GET /api/external/v2/subscription-contract-details/{contractId}/pending-downgrade
Version: 0.0.1

## Query parameters:

  - `api_key` (string)
    API Key (Deprecated - Use Header X-API-Key instead)

## Header parameters:

  - `X-API-Key` (string)

## Path parameters:

  - `contractId` (integer, required)
    The subscription contract ID
    Example: 12345

## Response 200 fields (application/json):

  - `shop` (string)

  - `contractId` (integer)

  - `waitTillTimestamp` (string)

  - `oldLineId` (string)

  - `oldVariantId` (string)

  - `newVariantId` (string)

  - `sellingPlanId` (string)

  - `sellingPlanName` (string)

  - `oldPrice` (number)

  - `newPrice` (number)

  - `newCustomerTag` (string)

  - `oldCustomerTags` (string)

  - `newOrderTag` (string)

  - `eventSource` (string)

  - `retryCount` (integer)

  - `customerId` (integer)

  - `executionArn` (string)

## Response 401 fields (*/*):

  - `shop` (string)

  - `contractId` (integer)

  - `waitTillTimestamp` (string)

  - `oldLineId` (string)

  - `oldVariantId` (string)

  - `newVariantId` (string)

  - `sellingPlanId` (string)

  - `sellingPlanName` (string)

  - `oldPrice` (number)

  - `newPrice` (number)

  - `newCustomerTag` (string)

  - `oldCustomerTags` (string)

  - `newOrderTag` (string)

  - `eventSource` (string)

  - `retryCount` (integer)

  - `customerId` (integer)

  - `executionArn` (string)

## Response 404 fields (*/*):

  - `shop` (string)

  - `contractId` (integer)

  - `waitTillTimestamp` (string)

  - `oldLineId` (string)

  - `oldVariantId` (string)

  - `newVariantId` (string)

  - `sellingPlanId` (string)

  - `sellingPlanName` (string)

  - `oldPrice` (number)

  - `newPrice` (number)

  - `newCustomerTag` (string)

  - `oldCustomerTags` (string)

  - `newOrderTag` (string)

  - `eventSource` (string)

  - `retryCount` (integer)

  - `customerId` (integer)

  - `executionArn` (string)