Description
When you subscribe to result notifications, Hill Labs sends you analytical test results after a report is approved or result data changes, such as when results are added or amended.
Hill Labs sends result data in the standard format by webhook using an HTTP POST request.
Receiving Results
To receive result notifications, contact the Hill Labs support team. Hill Labs will configure your organisation and send results to an endpoint you choose. You can secure notifications with Basic Authentication or an API key.
Discuss and configure result notifications during onboarding.
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 onboarding, your Hill Labs contact will gather your requirements and provide example results for 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"
}
}
]
}
]
}