Skip to main content
GET
/
trackers
/
{trackerPublicId}
/
values
List tracker values
curl --request GET \
  --url https://app.concretehq.com/api/v1/trackers/{trackerPublicId}/values \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "publicId": "val123abc456",
      "companyPublicId": "cmp456def789",
      "kind": "money",
      "value": 24000000,
      "unit": "USD",
      "period": {
        "kind": "point_in_time",
        "denomination": "year"
      },
      "note": "We closed May at $24M ARR, up 18% since our February update, with net revenue retention holding at 124%.",
      "origin": "system",
      "status": "confirmed",
      "citations": [
        {
          "type": "file",
          "publicId": "fil789ghi012",
          "name": "Acme May 2026 Investor Update.pdf",
          "extension": "pdf",
          "permalink": "https://app.concretehq.com/v/fil789ghi012"
        }
      ],
      "effectiveAt": "2026-05-31",
      "reportedAt": "2026-06-01T12:00:00Z",
      "createdAt": "2026-06-02T08:14:09Z",
      "updatedAt": "2026-06-02T08:14:09Z",
      "statusUpdatedAt": "2026-06-03T16:40:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token format

Path Parameters

​
trackerPublicId
string
required

Tracker public ID

Query Parameters

​
pageToken
string

Token for pagination to get next page

​
limit
integer
default:100

Number of results per page (default: 100, max: 100)

Required range: 1 <= x <= 100
​
companyPublicId
string

Only values for this company

​
status
enum<string>[]

Only values with these review statuses. Repeat the parameter to pass multiple (e.g. ?status=confirmed&status=rejected).

Available options:
suggested,
confirmed,
rejected
​
effectiveAfter
string<date>

Only values effective on or after this date (inclusive, YYYY-MM-DD)

​
effectiveBefore
string<date>

Only values effective on or before this date (inclusive, YYYY-MM-DD)

​
updatedAfter
string<date-time>

Only values changed at or after this instant (inclusive, ISO 8601). "Changed" covers content edits and review-status changes.

​
sort
enum<string>
default:effectiveAt

Sort order. May be effectiveAt, the date the value is valid for, or updatedAt, the date the value was last changed. Both newest first.

Available options:
effectiveAt,
updatedAt

Response

List of tracker values

​
items
object[]
required
​
nextPageToken
string

Token for fetching next page

Example:

"next_page_token_here"