---
title: "Get a list of collections with optional filtering"
method: POST
path: "/collections/index/{filter}"
tags: ["Collections"]
---

# Get a list of collections with optional filtering

`POST /collections/index/{filter}`

## Path parameters

- `filter` 'my_collections' | 'org_collections', required

## Request body

- object
  - `Collection.uuid` string
  - `Collection.type` string
  - `Collection.name` string

## Response `200`

A list of collections

- object[]
  - `Collection` CollectionFullNoElements
    - `id` string
    - `org_id` string
    - `orgc_id` string
    - `uuid` string, uuid
    - `created` string
    - `modified` string
    - `Org` EventOrganisation
      - `id` string
      - `name` string
      - `uuid` string, uuid
    - `Orgc` EventOrganisation
      - `id` string
      - `name` string
      - `uuid` string, uuid
    - `type` 'campaign' | 'intrusion_set' | 'named_threat' | 'other' | 'research'
    - `name` string
    - `description` string
    - `distribution` '0' | '1' | '2' | '3' | '4' | '5' — Who will be able to see this event once it becomes published and eventually when it becomes pulled: * `0` - Your organization only * `1` - This community only * `2` - Connected communities * `3` - All communities * `4` - Sharing group * `5` - Inherit Event
    - `sharing_group_id` union
      - string, nullable
      - string, uuid, nullable

## Other responses

- `403` — Authentication failed. Please make sure you pass the API key of an API enabled user along in the Authorization header.
- `default` — Unexpected API error

## Changes

- **2025-12-11** `0a9c9382121a` — 3 breaking, 1 info
  - the `items/Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response property's maxLength was unset from `10` for the response status `200`
  - added `#/components/schemas/SharingGroupIntId, #/components/schemas/SharingGroupUuidId` to the `items/Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response property `oneOf` list for the response status `200`
  - the `items/Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - the `items/Collection/allOf[#/components/schemas/BaseCollection]/sharing_group_id` response's property pattern `^\d+$|^$` was removed for the status `200`
- **2025-05-22** `806822934e5e` — 1 info
  - endpoint added
- **2024-07-11** `7cd8b1880b11` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/misp/apis/misp-automation-api/changes/collections/index/:filter/post.md)

---

[API](https://skmtc.dev/misp/apis/misp-automation-api.md) · [All operations](https://skmtc.dev/misp/apis/misp-automation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/misp/misp-automation-api/revisions/88b34ff032a1/schema)