---
title: "List all Chart of Accounts Templates"
method: GET
path: "/books/agent-coa-templates"
tags: ["Books"]
---

# List all Chart of Accounts Templates

`GET /books/agent-coa-templates`

Retrieve a paginated list of all default and agent-owned Chart of Accounts templates. These templates can be used when creating new Books instances for clients.

## Query parameters

- `pageToken` string — token for pagination
- `limit` integer — The number of records to return. Max limit is 100.
- `expand` 'ledgers' — Comma-separated list of expandable paths.

## Response `200`

- GetBooksAPIAgentCoaTemplatesResponse — Response containing a list of agent COA templates.
  - `agentTemplates` BooksChartOfAccountsTemplate[], required — Agent-created COA templates
    - `accountingBasis` 'cash' | 'accrual', required — The accounting basis of the template
    - `id` string, base58 (max length 22), required — The ID of the template
    - `name` string, required — The name of the template
    - `type` 'agent' | 'platform', required — Whether this template belongs to an agent or a platform
  - `defaultTemplates` BooksChartOfAccountsTemplate[], required — Platform default COA templates available to this agent
    - `accountingBasis` 'cash' | 'accrual', required — The accounting basis of the template
    - `id` string, base58 (max length 22), required — The ID of the template
    - `name` string, required — The name of the template
    - `type` 'agent' | 'platform', required — Whether this template belongs to an agent or a platform
  - `nextPageToken` string, nullable — Token for fetching the next page of results
  - `prevPageToken` string, nullable — Token for fetching the previous page of results

## Other responses

- `400` — Invalid `expand` or `limit` or `pageToken`

---

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