---
title: "List upcoming contract renewals + notice deadlines"
method: GET
path: "/api/v1/renewals"
---

# List upcoming contract renewals + notice deadlines

`GET /api/v1/renewals`

## Request

- Base URL: `https://lvlupauto.com`
- URL: `https://lvlupauto.com/api/v1/renewals`
- Auth: HTTP bearer

The dealer's stack vendors with an upcoming contract renewal, each with the server-computed notice deadline (contract_end minus notice_period_days) and days remaining. Answers the moat question 'what auto-renews in N days and when is the notice deadline?'. Pass within_days to narrow to vendors whose notice deadline falls within that window. Own-stack read — no cohort.

## Query parameters

- `within_days` integer

## Response `200`

Success

## Other responses

- `401`: Unauthorized — invalid or missing token
- `403`: Insufficient scope
- `422`: Validation error
- `429`: Rate limited or cap exceeded

---

[API](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api.md) · [All operations](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lvlupauto/apis/lvl-up-auto-headless-api/revisions/805626b3a4ef?raw)