---
title: "Commitments"
method: GET
path: "/v1/commitments"
tags: ["Owner"]
---

# Commitments

`GET /v1/commitments`

## Request

- Base URL: `https://api.vicem.ai`
- URL: `https://api.vicem.ai/v1/commitments`
- Auth: HTTP bearer

## Query parameters

- `scope` 'open' | 'today'

## Response `200`

OK

- CommitmentsResponse
  - `items` object[], required
    - `id` string, required
    - `interactionId` string, required
    - `who` 'owner' | 'caller', required
    - `kind` 'promise' | 'event' | 'deadline' | 'todo' | 'bring' | 'callback', required
    - `text` string, required
    - `dueAt` string, date-time, required
    - `dueText` string, nullable, required
    - `hasTime` boolean, required
    - `status` 'open' | 'done' | 'dismissed', required
    - `seq` integer, required
  - `dueToday` integer, required
  - `overdue` integer, required

## Other responses

- `400`: Invalid request (body not JSON, or schema validation failed).
- `401`: Missing, expired or invalid bearer token.
- `500`: Unexpected server error (reported to Sentry).

---

[API](https://skmtc.dev/vicem/apis/vicem-api.md) · [All operations](https://skmtc.dev/vicem/apis/vicem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vicem/apis/vicem-api/revisions/9efcec07e5f4?raw)