---
title: "List Redis instances"
method: GET
path: "/redis"
tags: ["Redis (Deprecated)"]
deprecated: true
---

# List Redis instances

`GET /redis`

> **Deprecated.**

List Redis instances matching the provided filters. If no filters are provided, all Redis instances are returned.
This API is deprecated in favor of the Key Value API.

## Query parameters

- `name` string[]
- `region` Region[]
- `createdBefore` string, date-time
- `createdAfter` string, date-time
- `updatedBefore` string, date-time
- `updatedAfter` string, date-time
- `ownerId` string[]
- `environmentId` string[]
- `cursor` string
- `limit` integer — Defaults to 20

## Response `200`

OK

- RedisWithCursor[]
  - `redis` Redis, required — A Redis instance
    - `id` string, required — The ID of the Redis instance
    - `createdAt` string, date-time, required — The creation time of the Redis instance
    - `updatedAt` string, date-time, required — The last updated time of the Redis instance
    - `status` 'creating' | 'available' | 'unavailable' | 'config_restart' | 'suspended' | 'maintenance_scheduled' | 'maintenance_in_progress' | 'recovery_failed' | 'recovery_in_progress' | 'unknown' | 'updating_instance', required
    - `region` 'frankfurt' | 'oregon' | 'ohio' | 'singapore' | 'virginia', required — Defaults to "oregon"
    - `plan` 'free' | 'starter' | 'standard' | 'pro' | 'pro_plus' | 'custom', required
    - `name` string, required — The name of the Redis instance
    - `owner` Owner, required
      - `id` string, required
      - `name` string, required
      - `email` string, required
      - `ipAllowList` CidrBlockAndDescription[]
        - `cidrBlock` string, required
        - `description` string, required — User-provided description of the CIDR block
      - `twoFactorAuthEnabled` boolean — Whether two-factor authentication is enabled for the owner. Only present if `type` is `user`.
      - `type` 'user' | 'team', required
    - `options` RedisOptions, required — Options for a Redis instance
      - `maxmemoryPolicy` string
      - `persistenceMode` 'journal_snapshot' | 'snapshot' | 'off' — The persistence mode for the Key Value instance. The default for paid instances is journal_snapshot (both journaling and snapshots). Only turn off persistence if you're using this Key Value instance as a cache and are okay with losing data. Free instances do not have persistence.
    - `ipAllowList` CidrBlockAndDescription[], required — The IP allow list for the Redis instance
      - `cidrBlock` string, required
      - `description` string, required — User-provided description of the CIDR block
    - `environmentId` string — The ID of the environment the Redis instance is associated with
    - `version` string, required — The version of Redis
    - `dashboardUrl` string, required — The URL to view the Redis instance in the Render Dashboard
  - `cursor` string, required

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `404` — Unable to find the requested resource.
- `409` — The current state of the resource conflicts with this request.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.net/render/apis/render-public-api.md) · [All operations](https://skmtc.net/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/render/render-public-api/versions/80e0ff74d033/schema)