Skip to main content
GET
/
trackers
/
{trackerPublicId}
Get tracker
curl --request GET \
  --url https://app.concretehq.com/api/v1/trackers/{trackerPublicId} \
  --header 'Authorization: Bearer <token>'
{
  "publicId": "trk123abc456",
  "name": "ARR",
  "kind": "money",
  "preferredUnit": "USD",
  "description": "Annual recurring revenue as most recently reported",
  "ingestionEnabled": true,
  "valuePolicy": {
    "kind": "point_in_time",
    "denomination": {
      "allowed": [
        "month",
        "year"
      ],
      "preferred": "year"
    }
  },
  "createdAt": "2026-01-10T09:00:00Z",
  "updatedAt": "2026-04-02T17:30:00Z"
}

Authorizations

Authorization
string
header
required

API key authentication using Bearer token format

Path Parameters

trackerPublicId
string
required

Tracker public ID

Response

Tracker details

A tracker defines a metric monitored across portfolio companies (e.g. ARR, headcount, cash balance). Concrete extracts tracker values from incoming emails, files, and meetings automatically; values can also be entered manually.

publicId
string
required

Tracker public ID

Example:

"abc123def456"

name
string
required

Tracker name

Example:

"ARR"

kind
enum<string>
required

Data type of the tracker. Determines the JSON type of each value's value field: boolean → boolean, text → string, money/number/percent/score → number.

Available options:
money,
number,
percent,
boolean,
text,
score
Example:

"money"

ingestionEnabled
boolean
required

Whether automatic extraction from incoming content is enabled

createdAt
string<date-time>
required

When the tracker was created

updatedAt
string<date-time>
required

When the tracker definition was last updated

preferredUnit
string | null

Preferred display unit for values (e.g. "USD", "employees")

Example:

"USD"

description
string | null

What this tracker measures

Example:

"Annual recurring revenue as most recently reported"

valuePolicy
object

Constraints on how values for this tracker are reported. Use it to interpret the period fields on values and the bounds of score trackers. Discriminated by kind; see each variant for details. Trackers without period semantics (e.g. boolean or text trackers) have a null valuePolicy.

Example:
{
"kind": "period_total",
"cadence": {
"allowed": [{ "unit": "quarter", "length": 1 }],
"preferred": { "unit": "quarter", "length": 1 }
}
}