Collect Visit And Specimen

openspecimen/rest/ng/visits/collect

Use this resource to add visit and collect specimens of that visit.

Use HTTP POST method to call this API by passing the below details in JSON format.

Below are the attributes which need to be sent in the request body:

Here both parameters are optional

1. If you pass only visit name API will return visit with given visit name
2. If you pass only spr number then API will return all visits with given spr number.

Result:

The response of this request will contains the details of the visits with anticipated and unplanned collection status.

Below is the example of the get visits by name:

{"visit":
  {
    "eventLabel":"Baseline",
    "eventPoint":10,
    "clinicalDiagnosis":"Not Specified",
    "clinicalStatus":"Not Specified",
    "activityStatus":"Active",
    "code":null,
    "eventId":4,
    "site":"Arkansas Hospital",
    "cpTitle":"Planned Clinical Study",
    "visitDate":1450377000000,
    "cprId":596,
    "status":"Complete"
  },
  "specimens":[
    {
      "initialQty":10,
      "label":null,
      "reqId":4,
      "storageLocation":{id":null,"name":null,"positionX":null,"positionY":null},
      "lineage":"New",
      "concentration":null,
      "status":"Collected",
      "closeAfterChildrenCreation":null,
      "collectionEvent":{"time":"2015-12-08T15:30:36.766Z"},
      "receivedEvent":{"time":"2015-12-08T15:30:36.766Z"},
      "children":[],
      "specimensPool":[]
    }
  ]
}

"visit": {"cprId": 596"eventId": 4"ppid": "DWP00014""eventLabel": "Baseline""eventPoint": 10"cpId": 2"cpTitle": "Planned Clinical Study""cpShortTitle": "A Planned Clinical Study FD""id": 726"name": "DWP00014_Baseline_331""clinicalDiagnosis": "Not Specified""clinicalStatus": "Not Specified""activityStatus": "Active""site": "Arkansas Hospital""status": "Complete""comments": null"surgicalPathologyNumber": null"sprName": null"missedReason": null"missedBy": null"sprLocked": false"visitDate": 1449595018823"code": null"cohort": null"extensionDetail": null}-"specimens": [1]0:  {"id": 2922"cpId": 2"cprId": 596"eventId": null"visitId": 726"visitName": "DWP00014_Baseline_331""cpShortTitle": "A Planned Clinical Study FD""reqId": 4"sortOrder": null"label": "DWP00014.WB.280""autoPrintLabelEnabled": false"barcode": null"type": "Whole Blood""specimenClass": "Fluid""lineage": "New""anatomicSite": "Not Specified""laterality": "Not Specified""status": "Collected""reqLabel": "EDTA Blood""pathology": "Not Specified""initialQty": 10"availableQty": 10"available": true"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": -1"name": null"positionX": null"positionY": null}-"storageType": "Virtual""collectionContainer": null"activityStatus": "Active""createdOn": 1449594960000"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PPI%.%SP_TYPE%.%SYS_UID%""biohazards": [0]"comments": null"closeAfterChildrenCreation": null"children": [1]0:  {"id": null"cpId": null"cprId": null"eventId": null"visitId": null"visitName": null"cpShortTitle": null"reqId": 5"sortOrder": null"label": null"autoPrintLabelEnabled": false"barcode": null"type": "Plasma""specimenClass": "Fluid""lineage": "Derived""anatomicSite": "Not Specified""laterality": "Not Specified""status": null"reqLabel": "Plasma""pathology": "Not Specified""initialQty": 5"availableQty": null"available": null"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": null"name": null"positionX": null"positionY": null}-"storageType": "Virtual""collectionContainer": "EDTA Vacutainer""activityStatus": null"createdOn": null"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PPI%.%SP_TYPE%.%SYS_UID%""biohazards": null"comments": null"closeAfterChildrenCreation": null"children": [5]0:  {"id": null"cpId": null"cprId": null"eventId": null"visitId": null"visitName": null"cpShortTitle": null"reqId": 6"sortOrder": null"label": null"autoPrintLabelEnabled": false"barcode": null"type": "Plasma""specimenClass": "Fluid""lineage": "Aliquot""anatomicSite": "Not Specified""laterality": "Not Specified""status": null"reqLabel": "Plasma""pathology": "Not Specified""initialQty": 1"availableQty": null"available": null"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": null"name": null"positionX": null"positionY": null}-"storageType": "Auto""collectionContainer": "EDTA Vacutainer""activityStatus": null"createdOn": null"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PSPEC_LABEL%.%PSPEC_UID%""biohazards": null"comments": null"closeAfterChildrenCreation": null"children": [0]"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}-1:  {"id": null"cpId": null"cprId": null"eventId": null"visitId": null"visitName": null"cpShortTitle": null"reqId": 7"sortOrder": null"label": null"autoPrintLabelEnabled": false"barcode": null"type": "Plasma""specimenClass": "Fluid""lineage": "Aliquot""anatomicSite": "Not Specified""laterality": "Not Specified""status": null"reqLabel": "Plasma""pathology": "Not Specified""initialQty": 1"availableQty": null"available": null"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": null"name": null"positionX": null"positionY": null}-"storageType": "Auto""collectionContainer": "EDTA Vacutainer""activityStatus": null"createdOn": null"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PSPEC_LABEL%.%PSPEC_UID%""biohazards": null"comments": null"closeAfterChildrenCreation": null"children": [0]"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}-2:  {"id": null"cpId": null"cprId": null"eventId": null"visitId": null"visitName": null"cpShortTitle": null"reqId": 8"sortOrder": null"label": null"autoPrintLabelEnabled": false"barcode": null"type": "Plasma""specimenClass": "Fluid""lineage": "Aliquot""anatomicSite": "Not Specified""laterality": "Not Specified""status": null"reqLabel": "Plasma""pathology": "Not Specified""initialQty": 1"availableQty": null"available": null"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": null"name": null"positionX": null"positionY": null}-"storageType": "Auto""collectionContainer": "EDTA Vacutainer""activityStatus": null"createdOn": null"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PSPEC_LABEL%.%PSPEC_UID%""biohazards": null"comments": null"closeAfterChildrenCreation": null"children": [0]"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}-3:  {"id": null"cpId": null"cprId": null"eventId": null"visitId": null"visitName": null"cpShortTitle": null"reqId": 9"sortOrder": null"label": null"autoPrintLabelEnabled": false"barcode": null"type": "Plasma""specimenClass": "Fluid""lineage": "Aliquot""anatomicSite": "Not Specified""laterality": "Not Specified""status": null"reqLabel": "Plasma""pathology": "Not Specified""initialQty": 1"availableQty": null"available": null"concentration": null"parentId": null"parentLabel": null"storageLocation": {"id": null"name": null"positionX": null"positionY": null}-"storageType": "Auto""collectionContainer": "EDTA Vacutainer""activityStatus": null"createdOn": null"code": null"distributed": null"collectionEvent": null"receivedEvent": null"labelFmt": "%PSPEC_LABEL%.%PSPEC_UID%""biohazards": null"comments": null"closeAfterChildrenCreation": null"children": [0]"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}[0]"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}--"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}--"pooledSpecimenId": null"pooledSpecimenLabel": null"specimensPool": null"closeParent": null"poolSpecimen": false"extensionDetail": null}--} 

{"visit":{"cprId":596,"eventId":4,"ppid":"DWP00014","eventLabel":"Baseline","eventPoint":10.0,"cpId":2,"cpTitle":"Planned Clinical Study","cpShortTitle":"A Planned Clinical Study FD","id":726,"name":"DWP00014_Baseline_331","clinicalDiagnosis":"Not Specified","clinicalStatus":"Not Specified","activityStatus":"Active","site":"Arkansas Hospital","status":"Complete","comments":null,"surgicalPathologyNumber":null,"sprName":null,"missedReason":null,"missedBy":null,"sprLocked":false,"visitDate":1449595018823,"code":null,"cohort":null,"extensionDetail":null},"specimens":[{"id":2922,"cpId":2,"cprId":596,"eventId":null,"visitId":726,"visitName":"DWP00014_Baseline_331","cpShortTitle":"A Planned Clinical Study FD","reqId":4,"sortOrder":null,"label":"DWP00014.WB.280","autoPrintLabelEnabled":false,"barcode":null,"type":"Whole Blood","specimenClass":"Fluid","lineage":"New","anatomicSite":"Not Specified","laterality":"Not Specified","status":"Collected","reqLabel":"EDTA Blood","pathology":"Not Specified","initialQty":10,"availableQty":10,"available":true,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":-1,"name":null,"positionX":null,"positionY":null},"storageType":"Virtual","collectionContainer":null,"activityStatus":"Active","createdOn":1449594960000,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PPI%.%SP_TYPE%.%SYS_UID%","biohazards":[],"comments":null,"closeAfterChildrenCreation":null,"children":[{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":5,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Derived","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":5.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Virtual","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PPI%.%SP_TYPE%.%SYS_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":6,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Aliquot","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":1.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Auto","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PSPEC_LABEL%.%PSPEC_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null},{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":7,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Aliquot","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":1.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Auto","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PSPEC_LABEL%.%PSPEC_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null},{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":8,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Aliquot","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":1.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Auto","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PSPEC_LABEL%.%PSPEC_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null},{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":9,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Aliquot","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":1.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Auto","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PSPEC_LABEL%.%PSPEC_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null},{"id":null,"cpId":null,"cprId":null,"eventId":null,"visitId":null,"visitName":null,"cpShortTitle":null,"reqId":10,"sortOrder":null,"label":null,"autoPrintLabelEnabled":false,"barcode":null,"type":"Plasma","specimenClass":"Fluid","lineage":"Aliquot","anatomicSite":"Not Specified","laterality":"Not Specified","status":null,"reqLabel":"Plasma","pathology":"Not Specified","initialQty":1.000000,"availableQty":null,"available":null,"concentration":null,"parentId":null,"parentLabel":null,"storageLocation":{"id":null,"name":null,"positionX":null,"positionY":null},"storageType":"Auto","collectionContainer":"EDTA Vacutainer","activityStatus":null,"createdOn":null,"code":null,"distributed":null,"collectionEvent":null,"receivedEvent":null,"labelFmt":"%PSPEC_LABEL%.%PSPEC_UID%","biohazards":null,"comments":null,"closeAfterChildrenCreation":null,"children":[],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null}],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null}],"pooledSpecimenId":null,"pooledSpecimenLabel":null,"specimensPool":null,"closeParent":null,"poolSpecimen":false,"extensionDetail":null}]}