# GET ```json metadata { "title": "GET", "description": "Returns the string value of a key.", "categories": ["docs","develop","stack","oss","rs","rc","oss","kubernetes","clients"], "arguments": [{"display_text":"key","key_spec_index":0,"name":"key","type":"key"}], "syntax_fmt": "GET key", "complexity": "O(1)", "group": "string", "command_flags": ["readonly","fast"], "acl_categories": ["@read","@string","@fast"], "since": "1.0.0", "arity": 2, "key_specs": [{"RO":true,"access":true,"begin_search":{"spec":{"index":1},"type":"index"},"find_keys":{"spec":{"keystep":1,"lastkey":0,"limit":0},"type":"range"}}], "tableOfContents": {"sections":[{"children":[{"id":"code-examples","title":"Code examples"}],"id":"examples","title":"Examples"},{"id":"redis-software-and-redis-cloud-compatibility","title":"Redis Software and Redis Cloud compatibility"},{"id":"return-information","title":"Return information"}]} , "codeExamples": [{"codetabsId":"set_and_get-stepget","description":"Foundational: Retrieve the string value of a key using GET (returns nil if key doesn\u0026amp;#39;t exist)","difficulty":"beginner","id":"get","languages":[{"clientId":"redis-py","clientName":"redis-py","id":"Python","langId":"python","panelId":"panel_Python_set_and_get-stepget"},{"id":"Node-js","panelId":"panel_Nodejs_set_and_get-stepget"},{"clientId":"jedis","clientName":"Jedis","id":"Java-Sync","langId":"java","panelId":"panel_Java-Sync_set_and_get-stepget"},{"clientId":"go-redis","clientName":"go-redis","id":"Go","langId":"go","panelId":"panel_Go_set_and_get-stepget"},{"id":"dotnet-Sync (SE-Redis)","panelId":"panel_Csharp-Sync (SERedis)_set_and_get-stepget"}]}] } ```## Code Examples Legend The code examples below show how to perform the same operations in different programming languages and client libraries: - **Redis CLI**: Command-line interface for Redis - **C# (Synchronous)**: StackExchange.Redis synchronous client - **C# (Asynchronous)**: StackExchange.Redis asynchronous client - **Go**: go-redis client - **Java (Synchronous - Jedis)**: Jedis synchronous client - **Java (Asynchronous - Lettuce)**: Lettuce asynchronous client - **Java (Reactive - Lettuce)**: Lettuce reactive/streaming client - **JavaScript (Node.js)**: node-redis client - **PHP**: Predis client - **Python**: redis-py client - **Rust (Synchronous)**: redis-rs synchronous client - **Rust (Asynchronous)**: redis-rs asynchronous client Each code example demonstrates the same basic operation across different languages. The specific syntax and patterns vary based on the language and client library, but the underlying Redis commands and behavior remain consistent. --- Get the value of `key`. If the key does not exist the special value `nil` is returned. An error is returned if the value stored at `key` is not a string, because `GET` only handles string values. ## Examples GET nonexisting SET mykey "Hello" GET mykey ### Code examples Foundational: Retrieve the string value of a key using GET (returns nil if key doesn't exist) **Difficulty:** Beginner **Available in:** Python, JavaScript (Node.js), Java (Synchronous - Jedis), Go, C#-Sync (SE.Redis) ##### Python ```python """ Code samples for data structure store quickstart pages: https://redis.io/docs/latest/develop/get-started/data-store/ """ import redis r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True) res = r.set("bike:1", "Process 134") print(res) # >>> True res = r.get("bike:1") print(res) # >>> "Process 134" ``` ##### JavaScript (Node.js) ```javascript import { createClient } from 'redis'; const client = createClient(); client.on('error', err => console.log('Redis Client Error', err)); await client.connect().catch(console.error); await client.set('bike:1', 'Process 134'); const value = await client.get('bike:1'); console.log(value); // returns 'Process 134' await client.close(); ``` ##### Java (Synchronous - Jedis) ```java package io.redis.examples; import redis.clients.jedis.RedisClient; public class SetGetExample { public void run() { RedisClient jedis = RedisClient.create("redis://localhost:6379"); String status = jedis.set("bike:1", "Process 134"); if ("OK".equals(status)) System.out.println("Successfully added a bike."); String value = jedis.get("bike:1"); if (value != null) System.out.println("The name of the bike is: " + value + "."); jedis.close(); } } ``` ##### Go ```go package example_commands_test import ( "context" "fmt" "github.com/redis/go-redis/v9" ) func ExampleClient_Set_and_get() { ctx := context.Background() rdb := redis.NewClient(&redis.Options{ Addr: "localhost:6379", Password: "", // no password docs DB: 0, // use default DB }) err := rdb.Set(ctx, "bike:1", "Process 134", 0).Err() if err != nil { panic(err) } fmt.Println("OK") value, err := rdb.Get(ctx, "bike:1").Result() if err != nil { panic(err) } fmt.Printf("The name of the bike is %s", value) } ``` ##### C#-Sync (SE.Redis) ```csharp using NRedisStack.Tests; using StackExchange.Redis; public class SetGetExample { public void Run() { var muxer = ConnectionMultiplexer.Connect("localhost:6379"); var db = muxer.GetDatabase(); bool status = db.StringSet("bike:1", "Process 134"); if (status) Console.WriteLine("Successfully added a bike."); var value = db.StringGet("bike:1"); if (value.HasValue) Console.WriteLine("The name of the bike is: " + value + "."); } } ``` ## Redis Software and Redis Cloud compatibility | Redis
Software | Redis
Cloud | Notes | |:----------------------|:-----------------|:------| | ✅ Standard
✅ Active-Active | ✅ Standard
✅ Active-Active | | ## Return information **RESP2:** One of the following: * [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): the value of the key. * [Nil reply](../../develop/reference/protocol-spec#bulk-strings): if the key does not exist. **RESP3:** One of the following: * [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): the value of the key. * [Null reply](../../develop/reference/protocol-spec#nulls): key does not exist.