---
title: "GET /v2/discussions"
method: GET
path: "/v2/discussions"
tags: ["discussions"]
---

# GET /v2/discussions

`GET /v2/discussions`

Returns the list of discussions for current user according to given filter

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `X-Caliopen-PI` string, required
- `X-Caliopen-IL` string, required

## Response `200`

Discussions returned

- object
  - `total` integer — number of discussions found for current user for the given parameters
  - `discussions` Discussion[]
    - `attachment_count` integer
    - `date_insert` string, date-time
    - `date_update` string, date-time
    - `discussion_id` string
    - `importance_level` integer
    - `participants` Participant[]
      - `address` string, required
      - `contact_ids` string[]
      - `label` string
      - `protocol` string, required
      - `type` 'To' | 'Cc' | 'Bcc' | 'From' | 'Reply-To' | 'Sender', required
    - `tags` string[]
    - `excerpt` string
    - `subject` string
    - `protocol` string
    - `total_count` integer
    - `unread_count` integer
    - `aliases` string[]
    - `last_message_id` string
    - `last_message_date` string, date-time
    - `last_message_subject` string

## Other responses

- `400` — malform request
- `401` — Unauthorized access

---

[API](https://skmtc.net/caliopen/apis/caliopen-http-rest-api.md) · [All operations](https://skmtc.net/caliopen/apis/caliopen-http-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/caliopen/caliopen-http-rest-api/revisions/f32b5d08284d/schema)