Results

Get presigned URL for test results

get

Returns a time-limited presigned URL to download normalized test results in FHIR format (JSON). The URL is valid for 15 minutes. Note: Every orderItemID can only be associated with maximum 1 panel, hence results can be uniquely identified by orderItemID.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

orderItemIDinteger · min: 1Required

Order Item ID

Query parameters

test_taker_idinteger · min: 1Required

Test Taker ID

Responses

200

Successfully generated download URL

application/json

Response containing a presigned URL to download test results

download_urlstringOptionalExample: https://storage.googleapis.com/bucket/results/123.json?signature=abc123

expires_atstringOptionalExample: 2025-10-23T18:00:00Z

formatstring · enumOptionalExample: jsonPossible values:

400

Invalid or missing order item ID

application/json

401

Unauthorized - invalid client credentials

application/json

404

Results not found for this order item

application/json

500

Internal server error

application/json

get

/api/v1/results/{orderItemID}

HTTPcURLJavaScriptPython

GET /api/v1/results/{orderItemID}?test_taker_id=1 HTTP/1.1
Host: vantage.tryterra.co
Authorization: Basic username:password
Accept: */*

{
  "download_url": "https://storage.googleapis.com/bucket/results/123.json?signature=abc123",
  "expires_at": "2025-10-23T18:00:00Z",
  "format": "json"
}

Acknowledge results receipt

post

Confirms that test results have been successfully retrieved and processed by the test taker/end user. Required for compliance and audit trails.

Authorizations

BasicAuth

AuthorizationstringRequired

Path parameters

orderItemIDinteger · min: 1Required

Order Item ID

Query parameters

test_taker_idinteger · min: 1Required

Test Taker ID

Responses

200

Results acknowledged successfully

application/json

Confirmation that results were acknowledged

statusstringOptionalExample: acknowledged

400

Invalid order item ID

application/json

401

Unauthorized - invalid credentials

application/json

404

Order item not found

application/json

500

Internal server error

application/json

post

/results/{orderItemID}/acknowledge

HTTPcURLJavaScriptPython

POST /results/{orderItemID}/acknowledge?test_taker_id=1 HTTP/1.1
Host: vantage.tryterra.co
Authorization: Basic username:password
Accept: */*

{
  "status": "acknowledged"
}