Jobs

In Truvera, "jobs" are blockchain transactions that we submit on your behalf. You can choose to either register a webhook or poll the API to receive job information. Certain things in the API, such as revoking a credential, require a blockchain transaction to finalize before the job can be considered "done". The time to wait varies on network load and other factors, but typically is within 5-10 seconds.

You can track the current job status by querying the job id returned as part of the initial API response that triggered the job. The work is done asynchronously.

Get Job Status and Data

To check the Job status and data, you can use the GET method and simply put the Job id. It will return information related to the job being processed and its associated blockchain transaction. On completion or failure, the job data will be updated with a response from the blockchain.

Parameters

Name	In	Type	Required	Description
id	path	JobId	true	Represents a Job id.

Get Job Status and data

Returns information related to the job being processed and its associated blockchain transaction. On completion or failure, the job data will be updated with a response from the blockchain. More info about Job Status

GEThttps://api-testnet.truvera.io/jobs/{id}

Path parameters

id*JobId (string)

Unique id of the background task. This id can be used to query the job status

Example: "900"

Response

200400404

Job description is returned.

Body

application/json

idJobId (string)

Unique id of the background task. This id can be used to query the job status

Example: "900"

statusJobStatus (enum)

Status of the job.

todofinalizedin_progresserror

resultobject

Request

JavaScriptCurlPython

const response = await fetch('https://api-testnet.truvera.io/jobs/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "id": "900",
  "status": "todo"
}