---
title: "Reads all Concepts"
method: GET
path: "/api/2026-10-01/resources/compensations/concepts"
tags: ["Compensations > Concept"]
---

# Reads all Concepts

`GET /api/2026-10-01/resources/compensations/concepts`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/compensations/concepts`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `payroll`
  - API key in header `x-api-key`

Retrieves compensation concepts (custom and default)

## Query parameters

- `ids[]` string[]: Filter by concept ids
- `categories[]` string[]: Return only the concepts in these categories: `earnings_fixed_salary`, `earnings_variable`, `earnings_benefits_in_kind`, `earnings_others`, `deductions`, `company_contribution` or `summarized_values`.
- `with_active_status` boolean: When true, returns only active concepts
- `enabled` boolean: When true, returns active concepts only; when false, only inactive
- `default` boolean: Set to true to return only the concepts Factorial ships by default, leaving out the ones the company created itself. Passing false has no effect.

## Response `200`

OK

- object
  - `data` CompensationsConcept[]
    - `id` string, required: The identifier of the concept
    - `category` 'earnings_fixed_salary' | 'earnings_variable' | 'earnings_benefits_in_kind' | 'earnings_others' | 'deductions' | 'company_contribution' | 'summarized_values': The accounting category of the concept (e.g. `earnings_fixed_salary`, `deductions`)
    - `company_id` string, required: The company identifier of the concept
    - `default` boolean, required: Whether the concept is a default or a custom concept
    - `description` string, required: The description of the concept
    - `label` string, required: The label of the concept
    - `name` string, required: The name of the concept
    - `translated_name` string, required: The translated name of the concept if it is a default concept.
    - `unit_name` string: The name of the unit of the concept
    - `unit_type` 'distance' | 'money' | 'time' | 'unit': What the concept's amount is measured in (e.g. `money`, a quantity of units)
    - `enabled` boolean, required: Whether the concept is enabled for the company
    - `created_at` string: Timestamp when the concept was created
    - `updated_at` string: Timestamp when the concept was last updated
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/compensations/concepts/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)