Jobs

In Truvera, API calls which depend on external systems may spawn jobs whose status can be queried until they complete. Examples include blockchain operations that we submit on your behalf and credential issuance via email. For instance, revoking a credential may require a blockchain transaction to finalize. This typically takes 5-10 seconds, depending on network load and other factors.

When an API call triggers a job, the response will contain a job ID that can be sent to this endpoint to track the job's status. Like other asynchronous operations, you can receive job information either by polling the API or registering a webhook.

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

get

https://api-testnet.truvera.iohttps://api.truvera.io

/jobs/{id}

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

Authorizations

bearerAuthaccessTokennextAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

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

Example: 900

Responses

200

Job description is returned.

application/json

Description of the job including result if available

idstringOptional

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

Example: 900

statusstring · enumOptional

Status of the job.

Possible values:

resultobjectOptional

400

Application error

application/json

404

Job id was not found.

application/json

get

/jobs/{id}

HTTPcURLJavaScriptPython

GET /jobs/{id} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "2436",
  "result": {
    "encodedTx": "0x9101040900d729a93bba53d7f3a4e81d7a3f4e61474d2736cbf4b872af7447342d5eede0c5d729a93bba53d7f3a4e81d7a3f4e61474d2736cbf4b872af7447342d5eede0c500de0e54cef15c9654aef41805b5624e28cd0d00a2cfb274ff4e4f1273dc0ae277",
    "userData": "did:cheqd:testnet:f48d2ace-4947-4cb7-8550-1cef3d63e651",
    "result": {
      "InBlock": "0x42a20e7e74001680ff7f1cb1833d5941c641c2961a46d655b72bb36e0dd602d3"
    }
  },
  "status": "finalized"
}