Fetch Vectors - Upstash Documentation

curl $UPSTASH_VECTOR_REST_URL/fetch \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0"], "includeMetadata": true }'

curl $UPSTASH_VECTOR_REST_URL/fetch/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0", "id-1"], "includeMetadata": true }'

{
    "result": [
        {
            "id": "id-0",
            "metadata": {
                "link": "upstash.com"
            }
        },
        {
            "id": "id-1"
        }
    ]
}

GET

fetch

{namespace}

curl $UPSTASH_VECTOR_REST_URL/fetch \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0"], "includeMetadata": true }'

curl $UPSTASH_VECTOR_REST_URL/fetch/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0", "id-1"], "includeMetadata": true }'

{
    "result": [
        {
            "id": "id-0",
            "metadata": {
                "link": "upstash.com"
            }
        },
        {
            "id": "id-1"
        }
    ]
}

You can fetch vector values or metadata of one or more by providing their vector ids or id prefix.

Vectors will be fetched from the default namespace by default. You can use a different namespace by specifying it in the request path.

Request

string[]

Array of vector ids to fetch.

string

Prefix of vector ids to fetch.

When you fetch vectors with an id prefix, at most 1000 vectors will be returned. If there are more vectors, please use the range API with an id prefix.

boolean

default:"false"

Whether to include the metadata of the vectors in the response, if any. It is recommended to set this to true to easily identify vectors.

boolean

default:"false"

Whether to include the vector values in the response. It is recommended to set this to false as the vector values can be quite big, and not needed most of the time.

boolean

default:"false"

Whether to include the data of the vectors in the response, if any.

Path

string

default:""

The namespace to use. When no namespace is specified, the default namespace will be used.

Response

Object[]

Array of vectors in the same order they provided in the ids array. Array elements can be null if no such vector exists with the provided id.

Hide child attributes

string

required

The id of the vector.

number[]

The dense vector value for dense and hybrid indexes.

Object[]

The sparse vector value for sparse and hybrid indexes.

Hide child attributes

number[]

Indices of the non-zero valued dimensions.

number[]

Values of the non-zero valued dimensions.

Object

The metadata of the vector, if any.

string

The unstructured data of the vector, if any.

curl $UPSTASH_VECTOR_REST_URL/fetch \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0"], "includeMetadata": true }'

curl $UPSTASH_VECTOR_REST_URL/fetch/ns \
  -H "Authorization: Bearer $UPSTASH_VECTOR_REST_TOKEN" \
  -d '{ "ids": ["id-0", "id-1"], "includeMetadata": true }'

{
    "result": [
        {
            "id": "id-0",
            "metadata": {
                "link": "upstash.com"
            }
        },
        {
            "id": "id-1"
        }
    ]
}

Stop Resumable Query Fetch Random Vector

⌘I

​Request

​Path

​Response

Request

Path

Response