---
title: "Specify the current accounting period"
method: POST
path: "/accountingPeriods"
tags: ["Accounting"]
---

# Specify the current accounting period

`POST /accountingPeriods`

Specify the start date of and open an accounting period, making it current

## Request body

- integer

## Response `200`

successful operation

- AccountingPeriod
  - `startDate` integer
  - `endDate` integer
  - `deferredRevenueBalance` number
  - `status` 'OPEN' | 'CLOSE_IN_PROGRESS' | 'CLOSED' | 'UPCOMING'
  - `syncStatus` 'NONE' | 'WAITING' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED'
  - `openedBy` string
  - `openedOn` integer
  - `closedBy` string
  - `closedOn` integer
  - `calculation` AccountingPeriodCalculation
    - `deferredRevenueStartingBalance` number
    - `deferredRevenueEndingBalance` number
    - `additionalRevenue` number
    - `recognizedRevenue` number
    - `unrecognizedRevenue` number
    - `unrecognizedTransactionCount` integer
  - `openedByUser` UserJson
    - `id` string
    - `displayName` string
    - `title` string
    - `email` string
    - `phoneNumber` string
    - `state` 'ACTIVE' | 'DISABLED' | 'EXPIRED'
    - `role` 'ADMIN' | 'FINANCE' | 'SALES' | 'SALES_MANAGER' | 'ACCOUNTANT' | 'BILLING_CLERK' | 'REVENUE_CLERK' | 'READ_ONLY' | 'EXECUTIVE' | 'CRM' | 'IMPORT' | 'BILLY_ADMIN' | 'BILLY_ENGINEER' | 'BILLY_SUPPORT' | 'BILLY_JOB'
    - `ssoOnly` boolean
    - `tenantName` string
    - `cognitoUserStatus` 'UNCONFIRMED' | 'CONFIRMED' | 'ARCHIVED' | 'COMPROMISED' | 'UNKNOWN' | 'RESET_REQUIRED' | 'FORCE_CHANGE_PASSWORD' | 'EXTERNAL_PROVIDER' | 'UNKNOWN_TO_SDK_VERSION'
    - `userGroups` UserGroupJson[]
      - `id` string
      - `entityIds` string[]
      - `name` string
      - `description` string
      - `users` string[]
      - `externalId` string
    - `approvalSegments` ApprovalSegmentJson[]
      - `id` string
      - `name` string
      - `description` string
      - `createdOn` integer
      - `updatedOn` integer
    - `hasAllEntitiesAccess` boolean
    - `availableEntities` EntityRef[]
      - `entityId` string, required
      - `displayId` string
      - `name` string, required
    - `entityIds` string[]
    - `externalId` string
    - `eventObjectId` string
  - `closedByUser` UserJson
    - `id` string
    - `displayName` string
    - `title` string
    - `email` string
    - `phoneNumber` string
    - `state` 'ACTIVE' | 'DISABLED' | 'EXPIRED'
    - `role` 'ADMIN' | 'FINANCE' | 'SALES' | 'SALES_MANAGER' | 'ACCOUNTANT' | 'BILLING_CLERK' | 'REVENUE_CLERK' | 'READ_ONLY' | 'EXECUTIVE' | 'CRM' | 'IMPORT' | 'BILLY_ADMIN' | 'BILLY_ENGINEER' | 'BILLY_SUPPORT' | 'BILLY_JOB'
    - `ssoOnly` boolean
    - `tenantName` string
    - `cognitoUserStatus` 'UNCONFIRMED' | 'CONFIRMED' | 'ARCHIVED' | 'COMPROMISED' | 'UNKNOWN' | 'RESET_REQUIRED' | 'FORCE_CHANGE_PASSWORD' | 'EXTERNAL_PROVIDER' | 'UNKNOWN_TO_SDK_VERSION'
    - `userGroups` UserGroupJson[]
      - `id` string
      - `entityIds` string[]
      - `name` string
      - `description` string
      - `users` string[]
      - `externalId` string
    - `approvalSegments` ApprovalSegmentJson[]
      - `id` string
      - `name` string
      - `description` string
      - `createdOn` integer
      - `updatedOn` integer
    - `hasAllEntitiesAccess` boolean
    - `availableEntities` EntityRef[]
      - `entityId` string, required
      - `displayId` string
      - `name` string, required
    - `entityIds` string[]
    - `externalId` string
    - `eventObjectId` string
  - `synthetic` boolean
  - `id` string
  - `entityId` string

---

[API](https://skmtc.net/dealhub/apis/quote-api.md) · [All operations](https://skmtc.net/dealhub/apis/quote-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dealhub/quote-api/revisions/c30f5b9fbfab/schema)