---
title: "Transaction Calendar"
method: GET
path: "/api/transactions/calendar"
tags: ["transactions"]
---

# Transaction Calendar

`GET /api/transactions/calendar`

## Query parameters

- `month` string, date, nullable
- `account_id` string, uuid, nullable
- `account_ids` string[], nullable

## Headers

- `X-Workspace-Id` string, nullable

## Response `200`

Successful Response

- TransactionCalendarResponse
  - `month` string, required
  - `currency` string, required
  - `account_ids` string[], nullable
  - `days` TransactionCalendarDay[], required
    - `date` string, date, required
    - `in_month` boolean, required
    - `ending_balance` number, required
    - `income` number
    - `expense` number
    - `transfer_net` number
    - `actual_count` integer
    - `projected_count` integer
    - `has_income` boolean
    - `has_expense` boolean
    - `has_transfer` boolean
    - `items` TransactionCalendarItem[]
      - `kind` 'actual' | 'projected', required
      - `id` string, uuid, nullable
      - `recurring_id` string, uuid, nullable
      - `date` string, date, required
      - `description` string, required
      - `amount` number, required
      - `amount_primary` number, nullable
      - `currency` string, required
      - `type` 'debit' | 'credit', required
      - `account_id` string, uuid, nullable
      - `account_name` string, nullable
      - `category_id` string, uuid, nullable
      - `category_name` string, nullable
      - `category_icon` string, nullable
      - `category_color` string, nullable
      - `status` string, nullable
      - `source` string, nullable
      - `transfer_pair_id` string, uuid, nullable
      - `is_transfer` boolean
      - `is_ignored` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/usesecuro/apis/securo.md) · [All operations](https://skmtc.dev/usesecuro/apis/securo/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usesecuro/securo/revisions/1df3dfa0c028/schema)