---
title: "Read month end close"
method: GET
path: "/accountant/month-end-close"
tags: ["Accountant Portal"]
---

# Read month end close

`GET /accountant/month-end-close`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/month-end-close`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Month-end checklist aggregated across the accountant's companies. Each company counts on its own close target: the oldest open GL period that has ended, the period readiness, the closing-entry preview and lock use. `period`, `periodKey` and `deadline` are set only when every targeted company shares one target; companies with nothing to close are left out of the counts.

## Response `200`

Portfolio month-end progress on each company's close target

- object
  - `success` boolean
  - `data` object
    - `period` string, nullable: Label of the close target, e.g. "August 2026". Null when there is nothing to close.
    - `periodKey` string, nullable: YYYY-MM of the close target. Null exactly when `period` is.
    - `status` 'completed' | 'in_progress' | 'not_started' | 'nothing_to_close': `nothing_to_close` when no open GL period has ended. The calendar month is never substituted.
    - `deadline` string, date, nullable: The 10th of the month after the close target. Null when there is nothing to close.
    - `overallProgress` integer
    - `startedAt` string, nullable
    - `sections` object[]: The close target's checklist steps. Empty when there is nothing to close.
      - `id` string
      - `title` string
      - `status` string
      - `progress` integer

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)