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.
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
],
"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,
"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
],
"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,
"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
],
"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
],
"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
],
"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
],
"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"
}
}
]
}
]
}