---
title: "List redirect rules"
method: GET
path: "/redirects"
tags: ["Redirects"]
---

# List redirect rules

`GET /redirects`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/redirects`
- Auth: HTTP bearer

Returns redirect rules for the authenticated account, sorted by source path. Supports cursor pagination and optional prefix search on `fromPath`.

## Query parameters

- `cursor` string: An opaque pagination cursor returned in the `nextCursor` field of a previous response.
- `limit` integer: A limit on the number of objects to be returned. Limit can range between 1 and 100.
- `search` string: Prefix match against `fromPath`. Only redirects whose source path starts with this value are returned.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` Redirect[], required
    - `id` string, required: Unique identifier for the redirect.
    - `object` 'redirect', required: String representing the object's type. Objects of the same type share the same value.
    - `fromPath` string, required: Source path matched by this redirect.
    - `toPath` string, required: Destination path or URL.
    - `statusCode` union, required: HTTP status code used when redirecting.
      - 301
      - 302
    - `createdAt` string, required: Time at which the redirect was created. ISO 8601 datetime.

## Other responses

- `400`: The request was malformed.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `400` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/redirects/get.md)

---

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