Skip to main content
GET
/
api
/
v2
/
tenants
/
{tenant}
/
databases
/
{database}
/
collections
/
{collection_id}
Retrieves a collection by ID or name.
curl --request GET \
  --url https://api.trychroma.com/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id} \
  --header 'x-chroma-token: <api-key>'
{
  "configuration_json": {
    "embedding_function": "<unknown>",
    "hnsw": "<unknown>",
    "spann": "<unknown>"
  },
  "database": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "log_position": 123,
  "name": "<string>",
  "tenant": "<string>",
  "version": 123,
  "dimension": 123,
  "metadata": "<unknown>",
  "schema": "<unknown>"
}

Authorizations

​
x-chroma-token
string
header
required

Path Parameters

​
tenant
string
required

Tenant ID

​
database
string
required

Database name

​
collection_id
string
required

UUID of the collection

Response

Collection found

​
configuration_json
object
required
​
database
string
required
​
id
string<uuid>
required

CollectionUuid is a wrapper around Uuid to provide a type for the collection id.

​
log_position
integer<int64>
required
​
name
string
required
​
tenant
string
required
​
version
integer<int32>
required
​
dimension
integer<int32> | null
​
metadata
object
​
schema
object

Schema representation for collection index configurations

This represents the server-side schema structure used for index management