---
title: "List GL classifications"
method: GET
path: "/accounting/v2beta/gl-classifications"
tags: ["GL Classifications"]
---

# List GL classifications

`GET /accounting/v2beta/gl-classifications`

## Request

- Base URL: `https://api.atlar.com`
- URL: `https://api.atlar.com/accounting/v2beta/gl-classifications`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/atlar/apis/atlar-api-v2/docs/accounting/v2beta/gl-classifications/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of GL classifications. For further details on Pagination, see the section above.

## Query parameters

- `type` string: Identifies the kind of ERP-specific classification. This is a free string, stored as the ERP reports it: - NetSuite built-in classifications are `CLASS`, `DEPARTMENT` and `LOCATION`. - NetSuite custom segments use the raw field key, for example `cseg_region`. - Business Central uses the dimension code.
- `glEntityId` string: Unique resource identifier.
- `name` string
- `inactive` boolean
- `limit` integer
- `token` string

## Response `200`

A list of GL classifications.

- object
  - `items` GLClassification[], required: A list of resources.
    - `id` string, required: Unique resource identifier.
    - `organizationId` string, required: Unique resource identifier for an Organization.
    - `thirdPartyId` string: ID of the third party (ERP) the classification originates from. Omitted if the integration has no third party.
    - `vendorValueId` string, required: ID of the classification value in the ERP.
    - `type` GLClassificationType, required: Describes the parent type that a GL classification value belongs to.
      - `type` string, required: Identifies the kind of ERP-specific classification. This is a free string, stored as the ERP reports it: - NetSuite built-in classifications are `CLASS`, `DEPARTMENT` and `LOCATION`. - NetSuite custom segments use the raw field key, for example `cseg_region`. - Business Central uses the dimension code.
      - `name` string, required: Human-readable name of the classification type, as shown in the ERP.
      - `fieldKey` string, required: The ERP-side field name to populate when this classification value is applied to a document or transaction line. For NetSuite, this is the field's scriptid: `class`, `department`, `location`, or `cseg_<segment>` for custom segments.
    - `name` string, required: Human-readable name of the classification value, as shown in the ERP.
    - `glEntityIds` string[]: GL entity ids this value may be used with. Empty means all GL entities in the organization (restricted principals cannot create or widen to org-wide scope).
    - `inactive` boolean, required: Whether the value is inactive in the ERP. Inactive classifications remain addressable by id; retire obsolete values with `inactive` true instead of deleting.
    - `version` integer, required: Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
    - `etag` string, required: [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) based on the resource version. This can be passed along in `If-Match` HTTP header when updating a resource to perform a conditional update.
    - `created` string, date-time, required: Time at which the resource was created.
    - `updated` string, date-time, required: Time at which the resource was last updated.
  - `nextToken` string, required: Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required: The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required: The page limit that was used for this request.

## Other responses

- `400`: Bad request.

## Changes

- **2026-11-03** `b49df1e4b3e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlar/apis/atlar-api-v2/changes/accounting/v2beta/gl-classifications/get.md)

---

[API](https://skmtc.dev/atlar/apis/atlar-api-v2.md) - [All operations](https://skmtc.dev/atlar/apis/atlar-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/atlar/apis/atlar-api-v2/revisions/b49df1e4b3e9?raw)