List Collections

This endpoint allows you to list collections.

POST /v1/collections/list

List Collections

cURL

curl --request POST \
  --url https://api.mixpeek.com/v1/collections/list \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {},
  "sort": {
    "field": "created_at",
    "direction": "desc"
  },
  "search": "<string>",
  "case_sensitive": false
}
'

200

{
  "results": [
    {
      "collection_name": "<string>",
      "input_schema": {
        "properties": {}
      },
      "output_schema": {
        "properties": {}
      },
      "feature_extractor": {
        "feature_extractor_name": "<string>",
        "version": "<string>",
        "feature_extractor_id": "<string>",
        "params": {},
        "parameters": {
          "chunk_overlap": 0,
          "chunk_size": 1000,
          "extractor_type": "text_extractor",
          "split_by": "none",
          "split_method": "time",
          "time_split_interval": 10
        },
        "input_mappings": {
          "image": "product_image",
          "text": "title"
        },
        "field_passthrough": [
          {
            "source_path": "<string>",
            "target_path": "title",
            "default": "Unknown",
            "required": false
          }
        ],
        "include_all_source_fields": false
      },
      "source": {
        "type": "bucket",
        "bucket_ids": [
          "bkt_marketing_videos"
        ],
        "source_namespace_id": "<string>",
        "collection_id": "col_video_frames",
        "collection_ids": [
          "col_us_products",
          "col_eu_products"
        ],
        "inherited_bucket_ids": [
          "bkt_marketing_videos"
        ],
        "source_filters": {
          "description": "Filter only video content",
          "filters": {
            "AND": [
              {
                "field": "blobs.type",
                "operator": "eq",
                "value": "video"
              }
            ]
          }
        }
      },
      "collection_id": "<string>",
      "description": "Video frames extracted at 1 FPS with CLIP embeddings",
      "source_bucket_schemas": null,
      "source_lineage": [
        {
          "source_config": {
            "type": "bucket",
            "bucket_ids": [
              "bkt_marketing_videos"
            ],
            "source_namespace_id": "<string>",
            "collection_id": "col_video_frames",
            "collection_ids": [
              "col_us_products",
              "col_eu_products"
            ],
            "inherited_bucket_ids": [
              "bkt_marketing_videos"
            ],
            "source_filters": {
              "description": "Filter only video content",
              "filters": {
                "AND": [
                  {
                    "field": "blobs.type",
                    "operator": "eq",
                    "value": "video"
                  }
                ]
              }
            }
          },
          "feature_extractor": {
            "feature_extractor_name": "<string>",
            "version": "<string>",
            "feature_extractor_id": "<string>",
            "params": {},
            "parameters": {
              "chunk_overlap": 0,
              "chunk_size": 1000,
              "extractor_type": "text_extractor",
              "split_by": "none",
              "split_method": "time",
              "time_split_interval": 10
            },
            "input_mappings": {
              "image": "product_image",
              "text": "title"
            },
            "field_passthrough": [
              {
                "source_path": "<string>",
                "target_path": "title",
                "default": "Unknown",
                "required": false
              }
            ],
            "include_all_source_fields": false
          },
          "output_schema": {
            "properties": {}
          }
        }
      ],
      "vector_indexes": [
        "<unknown>"
      ],
      "payload_indexes": [
        "<unknown>"
      ],
      "enabled": true,
      "metadata": {
        "environment": "production",
        "project": "Q4_campaign",
        "team": "data-science"
      },
      "schedule": {
        "trigger_type": "<string>",
        "schedule_config": {},
        "description": "<string>"
      },
      "trigger_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "lifecycle_state": "active",
      "s3_vector_index": "<string>",
      "last_lifecycle_transition": "2023-11-07T05:31:56Z",
      "tiering_rules": [
        {
          "rule_type": "auto_evict",
          "enabled": false,
          "threshold_days": 123
        }
      ],
      "document_count": 123,
      "schema_version": 1,
      "last_schema_sync": "2023-11-07T05:31:56Z",
      "schema_sync_enabled": true,
      "document_schema": null,
      "schema_validation": "off",
      "taxonomy_applications": null,
      "cluster_applications": null,
      "alert_applications": null,
      "retriever_enrichments": null,
      "taxonomy_count": 123,
      "retriever_count": 123
    }
  ],
  "pagination": {
    "total": 123,
    "page": 123,
    "page_size": 123,
    "total_pages": 123,
    "next_page": "<string>",
    "previous_page": "<string>",
    "next_cursor": "<string>"
  },
  "total_count": 123,
  "stats": {
    "total_documents": 0,
    "avg_documents_per_collection": 0,
    "collections_with_taxonomies": 0,
    "total_feature_extractors": 0,
    "total_taxonomies": 0,
    "total_retrievers": 0
  }
}

Headers

Authorization · string

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

authorization · string

X-Namespace · string

Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'. Falls back to ?namespace= query parameter if the header is omitted.

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Query Parameters

limit · integer | null

Required range: 1 <= x <= 1000

offset · integer | null

Required range: 0 <= x <= 10000

cursor · string | null

include_total · boolean · default: false

Body

application/json

Request model for listing collections.

To filter by taxonomy, use dot notation in filters: filters.AND = [{"field": "taxonomy_applications.taxonomy_id", "operator": "eq", "value": "tax_123"}]

filters · Filters · object

Filters to apply when listing collections. Supports nested field filtering like 'taxonomy_applications.taxonomy_id'. Format: {"AND": [{"field": "field_name", "operator": "eq", "value": "value"}]}

sort · SortOption · object

Sort options for the results

Show child attributes

search · string | null

Search term for wildcard search across collection_id, collection_name, description, and other text fields

case_sensitive · boolean · default: false

If True, filters and search will be case-sensitive

Response

200

application/json

Successful Response

Response model for listing collections.

results · CollectionResponse · object[] · required

List of collections

Show child attributes

pagination · PaginationResponse · object · required

Pagination information

Show child attributes

total_count · integer · required

Total number of collections matching the query

stats · CollectionListStats · object

Aggregate statistics across all collections in the result

Show child attributes