---
title: "Retrieve a paginated list of dimensions"
method: GET
path: "/dimensions"
tags: ["dimensions"]
---

# Retrieve a paginated list of dimensions

`GET /dimensions`

Returns a paginated list of dimensions, filterable by company and type. The `detail=basic` query parameter returns a simplified response with only `id`, `name`, `erp_dimension_id`, and `erp_type` per item (omitting `code`, `reference_id`, `ottimate_type`, and `ottimate_company_id`).

## Query parameters

- `ottimate_company_id` integer
- `erp_type` string
- `detail` 'basic'
- `page` integer
- `limit` integer

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successful response with paginated dimension list

- DimensionsGetDimensionsRootResponse200
  - `version` string, required
  - `count` integer, required
  - `page` integer, required
  - `limit` integer, required
  - `dimensions` DimensionsGetResponsesContentApplicationJsonSchemaDimensionsItems[], required
    - `id` string, required — Unique Ottimate dimension identifier
    - `name` string, required — Display name of the dimension
    - `erp_type` string, required — The dimension category label as displayed in the client's ERP system. This is client-specific and varies by accounting software (e.g., 'Account', 'GLACCOUNT', 'GL_ACCOUNT' may all represent GL accounts).
    - `code` string — The GL code or short identifier associated with this dimension in the client's general ledger or ERP system.
    - `reference_id` string — A unique reference identifier that tracks this dimension across all client systems (ERP, inventory management, Ottimate). Used to correlate the same dimension across different platforms.
    - `ottimate_type` 'account' | 'location' | 'department' | 'class' | 'project' | 'customer' | 'entity' | 'item' | 'warehouse' | 'task' | 'cost_type' | 'employee' | 'tax_code' | 'property' | 'company' | 'subsidiary' — Ottimate's standardized dimension type code. This maps to Ottimate's internal dimension classification system, providing a consistent categorization regardless of how the client's ERP names it.
    - `erp_dimension_id` string, required — The identifier assigned to this dimension by the client's ERP software
    - `ottimate_company_id` integer — The Ottimate company ID this dimension belongs to

## Other responses

- `400` — Bad request - Invalid parameters or request format
- `401` — Unauthorized - Authentication required or invalid credentials
- `403` — Forbidden - Access denied or insufficient permissions

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)