---
title: "Returns user-defined custom column (derived metric) definitions."
method: GET
path: "/custom-columns"
tags: ["Tracker"]
---

# Returns user-defined custom column (derived metric) definitions.

`GET /custom-columns`

Returns the list of custom columns configured for this account. Custom columns are
user-defined derived metrics with formulas (e.g. calculated EPC variants, margin
formulas, blended scores).

## Relationship to reports

Each custom column has a name that can be passed directly as a column value in
report API calls, alongside built-in metrics like visits or roi.

## Usage

Call this endpoint at startup and append all custom column names to your default
report column set. Accounts with active custom columns will produce incomplete
analysis if these are excluded — they may represent the primary metrics the user
cares about.

## Response `200`

Custom columns configuration

---

[API](https://skmtc.net/voluum/apis/voluum-api.md) · [All operations](https://skmtc.net/voluum/apis/voluum-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voluum/voluum-api/versions/ebf61c973cf2/schema)