Description
This service pushes Analytical Test Results to subscribing customers. This process is triggered within our LIMS on Report Approval or where results data has changed i.e. new results or Amended results.
By default, result data is provided in a standard format via webhook (HTTP POST Method).
Receiving Results
If you wish to receive results via this method we will need to set up your organisation and push to an endpoint of your choosing. We are able to secure this notification with Basic Auth or an API Key.
This should be discussed and implemented during the onboard process.
Schema
Testing: https://cat-cdn.hill-laboratories.com/json-schema/client-api/v3/StandardResultsSchema.json
Production: https://cdn.hill-laboratories.com/json-schema/client-api/v3/StandardResultsSchema.json
Example Results
During the onboard process support will gather your specific requirements and provide some tailored results for your development.
Generic Use Cases
Push Results – Single Sample, Single Test
{
"resourceType": "standard-results.v1",
"orderId": 8066,
"jobIds": [
506086
],
"analystComments": "This is an example comment",
"orderReferences": [
{
"name": "ClientRef",
"value": "Test"
}
],
"organisations": [
{
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
]
}
],
"addresses": [
{
"address1": "1023 Rocky Road",
"city": "Smalltown",
"country": "New Zealand",
"postCode": "1234",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "Single Sample, Single Test Example",
"samples": [
{
"name": "Selenium",
"sequence": 1,
"clientSampleId": "Test-1234",
"sampleType": {
"sampleTypeCode": "CLOVER|P3"
},
"analyticalTests": [
{
"code": "Se"
}
],
"testResults": [
{
"jobId": 506086,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-07-30T13:13:54+12:00",
"measurandCode": "Se_mg/kg",
"result": {
"unitOfMeasure": "mg/kg",
"detectionLimit": 0.01,
"formattedDetectionLimit": "0.01",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.443406991487505,
"lowerConfidenceLimit95Percent": 1.11318601702499,
"upperConfidenceLimit95Percent": 2.88681398297501,
"sampleTypeRangePercentage": 101,
"numericResult": 2,
"formattedResult": "2.00"
}
}
]
}
]
}Push Results – Multiple sample references
{
"resourceType": "standard-results.v1",
"orderId": 8066,
"jobIds": [
506086
],
"analystComments": "This is an example comment",
"orderReferences": [
{
"name": "ClientRef",
"value": "Test"
}
],
"organisations": [
{
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
]
}
],
"addresses": [
{
"address1": "1023 Rocky Road",
"city": "Smalltown",
"country": "New Zealand",
"postCode": "1234",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "",
"samples": [
{
"name": "Selenium",
"sequence": 1,
"clientSampleId": "Test-1234",
"sampleType": {
"sampleTypeCode": "CLOVER|P3"
},
"references": [
{
"name": "clientSampleID",
"value": "My client sample ID value"
},
{
"name": "SampleNotes",
"value": "My sample notes"
}
],
"analyticalTests": [
{
"code": "Se"
}
],
"testResults": [
{
"jobId": 506086,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-07-30T13:13:54+12:00",
"measurandCode": "Se_mg/kg",
"result": {
"unitOfMeasure": "mg/kg",
"detectionLimit": 0.01,
"formattedDetectionLimit": "0.01",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.443406991487505,
"lowerConfidenceLimit95Percent": 1.11318601702499,
"upperConfidenceLimit95Percent": 2.88681398297501,
"sampleTypeRangePercentage": 101,
"numericResult": 2,
"formattedResult": "2.00"
}
}
]
}
]
}Methamphetamine Testing
Push Results – Single Methamphetamine Test
{
"resourceType": "standard-results.v1",
"orderId": 8046,
"jobIds": [
506049
],
"analystComments": "This is an example comment",
"orderReferences": [
{
"name": "ClientRef",
"value": "Test"
}
],
"organisations": [
{
"name": "Contoso Limited",
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
],
"contacts": [
{
"orderRoles": [
"PRIMARY",
"SUBMITTER",
"REGISTERED_BY"
],
"lastName": "Bloggs",
"firstName": "Joe",
"email": "user@email.com"
}
]
}
],
"addresses": [
{
"address1": "1023 Rocky Road",
"city": "Smalltown",
"country": "New Zealand",
"postCode": "1234",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "",
"samples": [
{
"name": "Sample1",
"sequence": 1,
"sampleType": {
"sampleTypeCode": "WIPE|cMiscWipe"
},
"analyticalTests": [
{
"code": "MethamphetamineP"
}
],
"testResults": [
{
"jobId": 506049,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-12T10:07:38+12:00",
"measurandCode": "amph_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 1,
"formattedResult": "1.00"
}
},
{
"jobId": 506049,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-12T10:07:38+12:00",
"measurandCode": "ephed_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 2,
"formattedResult": "2.0"
}
},
{
"jobId": 506049,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-12T10:07:38+12:00",
"measurandCode": "methamp_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.04",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00669897503371971,
"lowerConfidenceLimit95Percent": 0.0697920499325606,
"upperConfidenceLimit95Percent": 0.0965879500674394,
"numericResult": 3,
"formattedResult": "3.0"
}
},
{
"jobId": 506049,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-12T10:07:38+12:00",
"measurandCode": "psdephed_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 4,
"formattedResult": "4.0"
}
}
]
}
]
}Push Results – Methamphetamine Composite Test
{
"resourceType": "standard-results.v1",
"orderId": 8048,
"jobIds": [
506051
],
"analystComments": "This is an example comment",
"organisations": [
{
"name": "Contoso Limited",
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
],
"contacts": [
{
"orderRoles": [
"PRIMARY",
"SUBMITTER",
"REGISTERED_BY"
],
"lastName": "Bloggs",
"firstName": "Joe",
"email": "user@email.com"
}
]
}
],
"addresses": [
{
"address1": "Private Bag 3205",
"address2": "",
"city": "Hamilton",
"region": "",
"country": "New Zealand",
"postCode": "3240",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "Meth Comp",
"samples": [
{
"name": "SAMPLE 1",
"sequence": 1,
"sampleType": {
"sampleTypeCode": "WIPE|cMiscWipe"
}
},
{
"name": "SAMPLE 2",
"sequence": 2,
"sampleType": {
"sampleTypeCode": "WIPE|cMiscWipe"
}
}
],
"sampleComposites": [
{
"name": "Composite of SAMPLE 1 & SAMPLE 2",
"samples": [
"SAMPLE 1",
"SAMPLE 2"
],
"analyticalTests": [
{
"code": "Meth_CompR"
}
],
"testResults": [
{
"jobId": 506051,
"isIanzAccredited": false,
"status": "FINAL",
"recordedAt": "2019-06-25T12:32:00+12:00",
"measurandCode": "Methamp_Contrib_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"numericResult": 4,
"formattedResult": "4.0"
}
},
{
"jobId": 506051,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-25T12:32:00+12:00",
"measurandCode": "amph_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 2,
"formattedResult": "2.0"
}
},
{
"jobId": 506051,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-25T12:32:00+12:00",
"measurandCode": "ephed_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 3,
"formattedResult": "3.0"
}
},
{
"jobId": 506051,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-25T12:32:00+12:00",
"measurandCode": "methamp_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 4,
"formattedResult": "4.0"
}
},
{
"jobId": 506051,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-25T12:32:00+12:00",
"measurandCode": "psdephed_ugsample",
"result": {
"unitOfMeasure": "µg/sample",
"detectionLimit": 0.0375,
"formattedDetectionLimit": "0.02",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 0.00807217442824423,
"numericResult": 5,
"formattedResult": "5.0"
}
}
]
}
]
}Honey Testing
Push Results – Example Honey Test
{
"resourceType": "standard-results.v1",
"orderId": 7981,
"jobIds": [
505984
],
"analystComments": "This is an example comment",
"orderReferences": [
{
"name": "ClientRef",
"value": "Test"
}
],
"organisations": [
{
"name": "Contoso Limited",
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
],
"contacts": [
{
"orderRoles": [
"PRIMARY",
"SUBMITTER",
"REGISTERED_BY"
],
"lastName": "Bloggs",
"firstName": "Joe",
"email": "user@email.com"
}
]
}
],
"addresses": [
{
"address1": "1023 Rocky Road",
"city": "Smalltown",
"country": "New Zealand",
"postCode": "1234",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "",
"samples": [
{
"name": "Sample1",
"sequence": 1,
"sampleType": {
"sampleTypeCode": "HoneyD"
},
"analyticalTests": [
{
"code": "Honey3in1"
}
],
"testResults": [
{
"jobId": 505984,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-06T10:10:57+12:00",
"measurandCode": "dha_mgkg_ar",
"result": {
"unitOfMeasure": "mg/kg",
"detectionLimit": 10,
"formattedDetectionLimit": "10",
"rangeIndicator": "BELOW_DETECTION_LIMIT",
"standardUncertainty": 3.00403608721412211,
"lowerConfidenceLimit95Percent": -5.00807217442824423,
"upperConfidenceLimit95Percent": 7.00807217442824423,
"numericResult": 1,
"formattedResult": "< 10"
}
},
{
"jobId": 505984,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-06T10:10:57+12:00",
"measurandCode": "hmf_mgkg_ar",
"result": {
"unitOfMeasure": "mg/kg",
"detectionLimit": 1,
"formattedDetectionLimit": "1.0",
"rangeIndicator": "BETWEEN_LIMITS",
"standardUncertainty": 0.00403608721412211,
"lowerConfidenceLimit95Percent": 1.00807217442824423,
"upperConfidenceLimit95Percent": 2.00807217442824423,
"numericResult": 2,
"formattedResult": "2.0"
}
},
{
"jobId": 505984,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2019-06-06T10:10:57+12:00",
"measurandCode": "mgo_mgkg_ar_calc",
"result": {
"unitOfMeasure": "mg/kg",
"detectionLimit": 5,
"formattedDetectionLimit": "5",
"rangeIndicator": "BELOW_DETECTION_LIMIT",
"standardUncertainty": 1.00403608721412211,
"lowerConfidenceLimit95Percent": -0.00807217442824423,
"upperConfidenceLimit95Percent": 6.00807217442824423,
"numericResult": 3,
"formattedResult": "< 5"
}
}
]
}
]
}Push Results – Example with Sample Parameters
{
"resourceType": "standard-results.v1",
"orderId": 7981,
"jobIds": [
505984
],
"analystComments": "This is an example comment",
"orderReferences": [
{
"name": "ClientRef",
"value": "Test"
}
],
"organisations": [
{
"name": "Contoso Limited",
"orderRoles": [
"PRIMARY_ORGANISATION",
"CHARGE_TO"
],
"contacts": [
{
"orderRoles": [
"PRIMARY",
"SUBMITTER",
"REGISTERED_BY"
],
"lastName": "Bloggs",
"firstName": "Joe",
"email": "user@email.com"
}
]
}
],
"addresses": [
{
"address1": "1023 Rocky Road",
"city": "Smalltown",
"country": "New Zealand",
"postCode": "1234",
"orderRoles": [
"INVOICE"
]
}
],
"notes": "Push Result test with Sample Parameters",
"samples": [
{
"name": "SAMPLE 1",
"sequence": 1,
"sampleType": {
"sampleTypeCode": "HoneyD"
},
"containers": [
{
"barcode": {
"value": "331000242126",
"type": "LINEAR"
}
}
],
"analyticalTests": [
{
"code": "UMFCert"
}
],
"sampleParameters": [
{
"parameterCode": "UMFLicence",
"parameterValue": "9999"
},
{
"parameterCode": "BatchNumber",
"parameterValue": "ABC-102345"
},
{
"parameterCode": "ExpectedGrade",
"parameterValue": "18.78"
},
{
"parameterCode": "BatchWeight",
"parameterValue": "25"
}
]
},
{
"name": "SAMPLE 2",
"sequence": 2,
"sampleType": {
"sampleTypeCode": "HoneyD"
},
"containers": [
{
"barcode": {
"value": "331000242127",
"type": "LINEAR"
}
}
],
"analyticalTests": [
{
"code": "C4"
}
],
"testResults": [
{
"jobId": 516835,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2023-02-09T18:56:39+00:00",
"result": {}
},
{
"jobId": 516835,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2023-02-09T18:56:39+00:00",
"measurandCode": "d13C_dif_permil",
"result": {
"unitOfMeasure": "‰",
"detectionLimit": -50,
"formattedDetectionLimit": "-50.0",
"rangeIndicator": "BETWEEN_LIMITS",
"numericResult": 0,
"formattedResult": "0.0"
}
},
{
"jobId": 516835,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2023-02-09T18:56:39+00:00",
"measurandCode": "C4Sugar_%",
"result": {
"unitOfMeasure": "%",
"detectionLimit": 0,
"formattedDetectionLimit": "0.0",
"rangeIndicator": "BETWEEN_LIMITS",
"numericResult": 0,
"formattedResult": "0.0"
}
},
{
"jobId": 516835,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2023-02-09T18:56:39+00:00",
"measurandCode": "d13C_hon_permil",
"result": {
"unitOfMeasure": "‰",
"detectionLimit": -100,
"formattedDetectionLimit": "-100",
"rangeIndicator": "BETWEEN_LIMITS",
"numericResult": 1,
"formattedResult": "1"
}
},
{
"jobId": 516835,
"isIanzAccredited": true,
"status": "FINAL",
"recordedAt": "2023-02-09T18:56:39+00:00",
"measurandCode": "d13C_pro_permil",
"result": {
"unitOfMeasure": "‰",
"detectionLimit": -100,
"formattedDetectionLimit": "-100",
"rangeIndicator": "BETWEEN_LIMITS",
"numericResult": 1,
"formattedResult": "1"
}
}
]
}
]
}