> ## Documentation Index
> Fetch the complete documentation index at: https://developers.pleo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> The Bookkeeping Categories API enables you to manage the bookkeeping categories customers use to classify expenses in Pleo.

export const RememberCallout = ({title, children}) => <div className="callout-box callout-remember">
    <div className="callout-row">
      <span className="callout-icon">
        <svg width="22" height="22" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor"><path d="M229.66,98.34,172.39,155.8c11.46,22.93-1.72,45.86-10.11,57a8,8,0,0,1-12,.83L42.34,105.76A8,8,0,0,1,43,93.85c29.65-23.92,57.4-10,57.4-10l57.27-57.46a8,8,0,0,1,11.31,0L229.66,87A8,8,0,0,1,229.66,98.34Z" opacity="0.2" /><path d="M235.32,81.37,174.63,20.69a16,16,0,0,0-22.63,0L98.37,74.49c-10.66-3.34-35-7.37-60.4,13.14a16,16,0,0,0-1.29,23.78L85,159.71,42.34,202.34a8,8,0,0,0,11.32,11.32L96.29,171l48.29,48.29A16,16,0,0,0,155.9,224c.38,0,.75,0,1.13,0a15.93,15.93,0,0,0,11.64-6.33c19.64-26.1,17.75-47.32,13.19-60L235.33,104A16,16,0,0,0,235.32,81.37ZM224,92.69h0l-57.27,57.46a8,8,0,0,0-1.49,9.22c9.46,18.93-1.8,38.59-9.34,48.62L48,100.08c12.08-9.74,23.64-12.31,32.48-12.31A40.13,40.13,0,0,1,96.81,91a8,8,0,0,0,9.25-1.51L163.32,32,224,92.68Z" /></svg>
      </span>
      <div>
        {title && <div className="callout-title">
            {title}
          </div>}
        <div className="callout-body">
          {children}
        </div>
      </div>
    </div>
  </div>;

export const NoteCallout = ({title, children}) => <div className="callout-box callout-note">
    <div className="callout-row">
      <span className="callout-icon">
        <svg width="22" height="22" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor"><path d="M208,104a79.86,79.86,0,0,1-30.59,62.92A24.29,24.29,0,0,0,168,186v6a8,8,0,0,1-8,8H96a8,8,0,0,1-8-8v-6a24.11,24.11,0,0,0-9.3-19A79.87,79.87,0,0,1,48,104.45C47.76,61.09,82.72,25,126.07,24A80,80,0,0,1,208,104Z" opacity="0.2" /><path d="M176,232a8,8,0,0,1-8,8H88a8,8,0,0,1,0-16h80A8,8,0,0,1,176,232Zm40-128a87.55,87.55,0,0,1-33.64,69.21A16.24,16.24,0,0,0,176,186v6a16,16,0,0,1-16,16H96a16,16,0,0,1-16-16v-6a16,16,0,0,0-6.23-12.66A87.59,87.59,0,0,1,40,104.49C39.74,56.83,78.26,17.14,125.88,16A88,88,0,0,1,216,104Zm-16,0a72,72,0,0,0-73.74-72c-39,.92-70.47,33.39-70.26,72.39a71.65,71.65,0,0,0,27.64,56.3A32,32,0,0,1,96,186v6h64v-6a32.15,32.15,0,0,1,12.47-25.35A71.65,71.65,0,0,0,200,104Zm-16.11-9.34a57.6,57.6,0,0,0-46.56-46.55,8,8,0,0,0-2.66,15.78c16.57,2.79,30.63,16.85,33.44,33.45A8,8,0,0,0,176,104a9,9,0,0,0,1.35-.11A8,8,0,0,0,183.89,94.66Z" /></svg>
      </span>
      <div>
        {title && <div className="callout-title">
            {title}
          </div>}
        <div className="callout-body">
          {children}
        </div>
      </div>
    </div>
  </div>;

## What is a Bookkeeping Category?

A bookkeeping category describes the purpose of an expense, such as travel, office supplies, or software. Bookkeeping categories help customers classify expenses consistently before exporting accounting entries to their ERP or accounting system.

Each bookkeeping category belongs to a bookkeeping category group. It can also be linked to an account from the customer's chart of accounts and to a tax code.

<RememberCallout title="Remember">
  The [Chart of Accounts API](/reference/accounts/chart-of-accounts-api-overview) is used to sync GL accounts from the Accounting System into Pleo. See the [Chart of Accounts Sync Overview](/docs/current/platform/accounting-integrations/imports/accounts/accounts-sync-overview) for how that sync works.

  <br />

  <br />

  The Bookkeeping Categories API is used to manage the internal Pleo mapping between synced Chart of Accounts entries and Pleo bookkeeping categories, via the category's `accountId`. This holds true even if the Chart of Accounts API isn't used and accounts are instead managed manually in the Pleo Web App: the `accountId` still refers to the same underlying Pleo account record either way.
</RememberCallout>

## Bookkeeping Category Management

The Bookkeeping Categories API allows you to create, retrieve, update, delete, and search for bookkeeping categories. Each bookkeeping category is identified by a unique `categoryId`.

* Create a bookkeeping category within an existing bookkeeping category group using the `POST Create a new bookkeeping category` endpoint.
* Retrieve a bookkeeping category by ID using the `GET Retrieve a bookkeeping category by its ID` endpoint.
* Update a bookkeeping category's name, category group, linked account, tax code, metadata, or archived status using the `PUT Update a bookkeeping category` endpoint.
* Delete a bookkeeping category using the `DELETE Delete a bookkeeping category` endpoint.
* Search for bookkeeping categories by category ID, category group ID, account ID, name, or archived status using the `POST Fetch a list of bookkeeping categories` endpoint.

<NoteCallout title="Note">
  Archive a bookkeeping category instead of deleting it when the category must remain available for historical bookkeeping data.
</NoteCallout>

## Bookkeeping Category Aggregations

Use the Bookkeeping Category Aggregations resource to retrieve bookkeeping category groups together with their bookkeeping categories and linked accounts for a company.

## Rate Limits

The APIs have a rate limit of 600 requests per minute.
