Merkl Developer Portal logo
post

/v4/analytics/beneficial-owners/build

Build the beneficial-owners tree in the background

A cold build of a large tree can outlast the gateway timeout. Call this route with the holders parameters until status is completed, then call holders and allocations: they answer from the cache for a few minutes. A call starts the build, or joins the one in progress. A failed build answers with its own error (409, 403, 404) once; the next call starts a new build.

Request body

object
chainIdnumber | string
required
tokenstring
required
atnumber | string
required

Responses

200
Response for status 200
Schema
object
jobIdstring
required
Unique job identifier
statusenum
required
pendingprocessingcompletedfailed
progressnumberProgress percentage of the job (0-100)
resultany
required
Result of the job if completed
errorstringError message if job failed
createdAtnumber
required
Timestamp when job was created
completedAtnumberTimestamp when job completed
durationSecondsnumber
required
Duration of the job in seconds (elapsed time if still processing, final duration if completed)
Example
{
  "jobId": "string",
  "status": "pending",
  "progress": 0,
  "result": null,
  "error": "string",
  "createdAt": 0,
  "completedAt": 0,
  "durationSeconds": 0
}