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

# Get classifications

`GET /accounting/v2beta/gl-classifications:batch`

## Request

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

Fetch multiple GL classifications by Atlar resource ID in one request (latest version of each).

## Query parameters

- `ids` string[], required

## Response `200`

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.
  - `failures` BatchGetFailure[], required
    - `id` string, required: Unique resource identifier.
    - `version` integer: Resource version that was requested. Present when the batch request used `idvs` (versioned keys); omitted for latest-only `ids` requests.
    - `code` string: Error code. Not always present.
    - `error` string: Error message. Not always present.
    - `retryable` boolean: Indication of whether this failure is retryable. If a resource (ID) was not found, or if the client is not authorized to get the resource, the failure is typically not retryable. If fetching some of the requested resources in were subject to throttling or rate-limiting, that may be retryable.

## 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:batch/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)