> ## 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 bookkeeping categories and the groups used to organise them 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>;

## Bookkeeping Categories

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>

## Category Groups

A bookkeeping category group collects related bookkeeping categories, such as travel, software, or office expenses. Each group has a type that describes its purpose, a customisable display name, and optional integration-specific metadata.

Use the Category groups resource to create, retrieve, update, delete, and search for groups. When creating or moving a bookkeeping category, identify its existing parent group by `categoryGroupId`.

## Managing Categories and Category Groups

Use the Categories resource to create, retrieve, update, delete, and search for bookkeeping categories. Each category is identified by a unique `categoryId`, and each group by a unique `categoryGroupId`.

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

  <br />

  <br />

  Archiving or unarchiving a bookkeeping category group applies the same status to every bookkeeping category in the group.
</NoteCallout>

## Category Aggregations

Use the 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.
