Skip to main content
GET
/
v1
/
external-trackers
/
{entityType}
/
{id}
List tracker values assigned to a VoC entity
curl --request GET \
  --url https://clientapi.woku.app/v1/external-trackers/{entityType}/{id} \
  --header 'Authorization: Bearer <token>'
[
  {
    "_id": "507f1f77bcf86cd799439015",
    "companyId": "507f1f77bcf86cd799439012",
    "entityType": "nps",
    "entityId": "507f1f77bcf86cd799439abc",
    "trackerId": "507f1f77bcf86cd799439014",
    "value": "TX-2026-00043",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

​
Authorization
string
header
required

Company API key. Obtain this from your Woku dashboard under Settings > API Keys. The same key used for the v0 endpoints.

Path Parameters

​
entityType
enum<string>
required

VoC entity type that carries the tracker value. woku is not allowed here; use the dedicated /v1/external-trackers/wokus/{wokuId} routes.

Available options:
nps,
csat,
ces,
form,
flow
​
id
string
required

MongoDB ObjectId of the VoC entity.

Pattern: ^[0-9a-fA-F]{24}$

Response

Array of values (may be empty)

​
_id
string
required
Example:

"507f1f77bcf86cd799439015"

​
companyId
string
required
Example:

"507f1f77bcf86cd799439012"

​
entityType
enum<string>
required

VoC entity type that carries this value.

Available options:
nps,
csat,
ces,
form,
flow
Example:

"nps"

​
entityId
string
required

VoC entity this value belongs to.

Example:

"507f1f77bcf86cd799439abc"

​
trackerId
string
required

Reference to the company-level tracker definition.

Example:

"507f1f77bcf86cd799439014"

​
value
string
required

External identifier (e.g. CRM transaction id).

Maximum string length: 500
Example:

"TX-2026-00043"

​
createdAt
string<date-time>
​
updatedAt
string<date-time>