---
title: "Get sale-page renewal choices"
method: GET
path: "/api/pages/renewal-options"
tags: ["Publishing", "Account"]
---

# Get sale-page renewal choices

`GET /api/pages/renewal-options`

## Request

- Base URL: `https://clearlist.me`
- URL: `https://clearlist.me/api/pages/renewal-options`
- Auth: one of:
  - API key in header `X-ClearList-API-Key`
  - OAuth 2 (authorization code, authorization URL `https://clearlist.me/oauth/authorize`, token URL `https://clearlist.me/api/oauth/token`)

Returns the authenticated seller's current page expiry and the renewal choices that can be fulfilled in full. Checkout URLs are omitted when the page is unpublished or no option is currently eligible.

## Response `200`

Current renewal state.

- object
  - `success` boolean
  - `data` object
    - `can_renew` boolean
    - `is_free` boolean
    - `page_expires_at` string, date-time, nullable
    - `days_until_page_expiry` integer, nullable
    - `is_expired` boolean
    - `options` object[]
      - `intent` 'free_renew' | 'time_only' | 'renew_pass' | 'upgrade'
      - `label` string
      - `detail` string
      - `priceUsd` number
      - `durationDays` integer
      - `addsCapacity` boolean
      - `sku` 'sale_pass' | 'big_move' | 'move_extension' | 'garage_extension'
      - `checkout_url` string, uri, nullable

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/clearlist/apis/clearlist-api.md) · [All operations](https://skmtc.dev/clearlist/apis/clearlist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clearlist/apis/clearlist-api/revisions/b1c1c4221cb8?raw)