---
title: "Close an accounting period"
method: PUT
path: "/v1/accounting-periods/{ap-id}/close"
tags: ["Accounting Periods"]
---

# Close an accounting period

`PUT /v1/accounting-periods/{ap-id}/close`

Close an accounting period by accounting period ID.

Prerequisites
-------------
You must have Zuora Finance enabled on your tenant. You must have the Manage Close Process and Run Trial Balance user permissions.

Limitations
-----------
* The accounting period cannot already be closed.
* The accounting period cannot be in the process of running a trial balance.
* All earlier accounting periods must be closed.
* There must be no required action items for the accounting period. See Reconcile Transactions Before Closing an Accounting Period for more information.

Notes
-----
When you close an accounting period in Zuora, a trial balance is automatically run for that period. A successful response means only that the accounting period is now closed, but does not mean that the trial balance has successfully completed.

## Path parameters

- `ap-id` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- CommonResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)