---
title: "Get GL classification"
method: GET
path: "/accounting/v2beta/gl-classifications/{id}"
tags: ["GL Classifications"]
---

# Get GL classification

`GET /accounting/v2beta/gl-classifications/{id}`

## Request

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

Retrieve a specific GL classification.

## Path parameters

- `id` string, required

## Response `200`

A GL classification.

- GLClassification: A selectable ERP dimension value used to tag journal lines — classes, departments, locations, and custom segments. Reference classifications by Atlar `id` on document `glEntries[].glClassificationIds`, creation templates, and reconciliation rules. Upsert identity in your ERP is (`type.type`, `thirdPartyId`, `vendorValueId`); use `:find` with that key, then create or patch. Reconciliation match create may reject lines when GL classification policies are violated (`gl_classification_policy_violation`). Classifications are not deletable. Rows imported by a connected ERP may be updated by the next sync.
  - `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.

## Other responses

- `404`: Resource not found.

## Changes

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

[Operation history](https://skmtc.dev/atlar/apis/atlar-api-v2/changes/accounting/v2beta/gl-classifications/:id/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)