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

# Set an accounting period to pending close

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

## Request

- Base URL: `https://rest.test.zuora.com`
- URL: `https://rest.test.zuora.com/v1/accounting-periods/{ap-id}/pending-close`
- Auth: HTTP bearer

Sets an accounting period to pending close.


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 be closed or pending close.
 
 * The accounting period cannot be in the process of running a trial balance.
 
 * All earlier accounting periods must be closed.

 

 
Notes
-----
When you set an accounting period to pending close in Zuora, a trial balance is automatically run for that period. A response of `{ "success": true }`  means only that the accounting period status is now pending close, but does not mean that the trial balance has successfully completed. You can use the Get Accounting Period REST API call to view details about the outcome of the trial balance.

## 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.dev/zuora/apis/api-reference/revisions/7b1cc52d24f3?raw)