---
title: "Get the filing state"
method: GET
path: "/filings"
tags: ["Filings"]
---

# Get the filing state

`GET /filings`

## Request

- Base URL: `https://api.app.lastaccountingcompany.com/portal`
- URL: `https://api.app.lastaccountingcompany.com/portal/filings`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/docs/filings/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the filing state for a period (default `this_month`): the resolved period, the VAT preview, filing drafts, filed returns, produced output packages, the latest review request, and the standing authorization state. Amounts are integer cents.

## Query parameters

- `customer_id` string
- `range` string

## Response `200`

Filing state for the selected period.

- object: Filing state for the selected period.
  - `period` object
  - `row_count` integer
  - `open_items` integer
  - `vat_preview` object
  - `review_system` object
  - `drafts` object[]
  - `filings` object[]
  - `outputs` object[]
  - `latest_request` object
  - `authorization` object

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Insufficient scope or role — e.g. a read-scoped key on a mutating method, or an API key on an admin/approver-only endpoint.

---

[API](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api.md) - [All operations](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lastaccountingcompany/apis/lac-customer-api/revisions/52e277b4f031?raw)