---
title: "List sites you can still restore"
method: GET
path: "/v1/sites/deleted"
tags: ["Sites"]
---

# List sites you can still restore

`GET /v1/sites/deleted`

## Request

- Base URL: `https://api.feelingsurf.fr`
- URL: `https://api.feelingsurf.fr/v1/sites/deleted`
- Auth: HTTP bearer

Sites you deleted within the retention window, most recently deleted first. Sites removed because a plan downgrade reduced your slot count are not listed: those come back on their own when you upgrade again.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

The caller's restorable sites.

- object
  - `data` DeletedSite[]
    - `id` integer: Unique identifier.
    - `url` string: The website's URL.
    - `name` string, nullable: Optional user-chosen name.
    - `total_visits` integer: Visits received before deletion.
    - `created_at` string, date-time, nullable: When the site was created (UTC).
    - `deleted_at` string, date-time, nullable: When the site was deleted (UTC). Restorable from this date.
  - `meta` PageMeta: Pagination metadata for a list response.
    - `limit` integer: Page size applied (clamped).
    - `offset` integer: Number of items skipped before this page.
    - `total` integer: Total number of items across all pages.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The request is not allowed. A banned or disabled account is rejected with `forbidden`; a site setting your plan does not include is rejected with `premium_required`.
- `429`: Too many requests — the per-account, per-minute rate limit was exceeded. Wait the number of seconds given in the `Retry-After` response header, then retry.

---

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