List an accounting book's legal entities

Operation ID: listBookEntityAssignments

Group: Accounting › Books

Open in the interactive reference

GET /accounting/books/{bookId}/entity-assignments

Read-only: Reads and returns; changes nothing.

Lists an accounting book's legal entities. Each legal entity comes with the chart of accounts, fiscal calendar, and currency it uses in this book.

This endpoint doesn't follow the standard collection rules in Pagination and querying:

This endpoint ignores any query parameter it doesn't declare, and returns no error. A request that follows the standard rules gets the first page, unfiltered, every time.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
bookId path string yes The unique identifier for the accounting book whose assignments to return.
page query string no The cursor from the previous response's data.pagination.nextCursor. Omit for the first page.
pageSize query string no The number of assignments per page. Defaults to 50. A value above 200 is treated as 200, not rejected.

Response

200 Success

Under data (listBookEntityAssignmentsOutput):

Field Type Required Description
items array<object> yes The book's entity assignments, one per legal entity that posts to it. An empty array when the book has none.
items[].id string yes The unique identifier for the entity assignment.
items[].bookId string yes The accounting book this assignment belongs to, the same book named on the path. See id on GET accounting/books/:id.
items[].bookName string no The display name of the accounting book.
items[].entityId string yes The legal entity assigned to the book. See id on GET base/entities.
items[].entityName string no The name of the assigned legal entity.
items[].chartOfAccountsId string no The chart of accounts used for this entity on this book. Absent when none is assigned. See id on GET accounting/chart-of-accounts/:id.
items[].chartOfAccountsName string no The name of the chart of accounts. Absent when none is assigned.
items[].fiscalCalendarId string no The fiscal calendar used for this entity on this book. Absent when none is assigned. See id on GET accounting/fiscal-calendars/:id.
items[].fiscalCalendarName string no The name of the fiscal calendar. Absent when none is assigned.
items[].currency string no The currency for this entity on this book. Format ISO 4217, for example 'USD'. Absent when none is set.
items[].lastModifiedDate date-time yes The date and time the entity assignment last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.
pagination object yes The pagination cursor for this page.
pagination.nextCursor string no The cursor for the next page. Pass it as the page query parameter. Absent on the last page.
pagination.hasMore boolean yes True when more assignments remain beyond this page. 
{
  "data": {
    "items": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "bookId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "bookName": "<bookName>",
        "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "entityName": "<entityName>",
        "chartOfAccountsId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "chartOfAccountsName": "<chartOfAccountsName>",
        "fiscalCalendarId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "fiscalCalendarName": "<fiscalCalendarName>",
        "currency": "<currency>",
        "lastModifiedDate": "2026-01-15T09:30:00.000Z"
      }
    ],
    "pagination": {
      "nextCursor": "<nextCursor>",
      "hasMore": true
    }
  },
  "diagnostics": [
    {
      "code": "<code>",
      "message": "<message>",
      "severity": "error",
      "path": [
        "<path>"
      ],
      "details": "<details>"
    }
  ]
}

Errors

Code Status
BOOK_NOT_FOUND 400

Statuses