# Items

 Items are the resource representing data shared by Individuals with MeasureOne.   The underlying document of an Item is called *source data*  These can be college transcripts, pay stubs, real estate titles, etc.   Items are stored and information from them can be retrieved through the Service API calls.   The information in an Item is shared through the Service APIs according to the consumer permission.   Importantly, note that unless permissioned by the Individual, the Item data may not be shared directly with you.


## Submit a new item

 - [POST /v3/items/new](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1new/post.md): ### Usage options 
  The usage of  varies depending on its intended use and availability of information. The request payload must include either a  object  a  object. Passing both as a part of the payload may result in processing errors.

  #### Using Source Data Object
  If the attribute values for a transcript are known, send the source data inline in the request using the  object. 

  #### Using Source Data Reference Object

  If the data is in a document, upload it using the  endpoint or make it available at a remote location. A reference to the uploaded document should then be included in the request using the  object. 


## Upload files

 - [POST /v3/items/upload](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1upload/post.md): The /items/upload endpoint is used to upload documents containing source data for a new item. 
: , , , , , 


## Get the details of item

 - [POST /v3/items/get_by_id](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1get_by_id/post.md): Retrieves an existing Item data. The endpoint can be used once the  for an Item is . It will return Item data in its response payload. If the processing of the Item is not yet complete, it will return the current status of the Item. This API is asynchronous. 

The optional  object, if present, lists data attributes whose extraction accuracy was lower than 95%. Such a scenario can come up when processing images or other unstructured source data items. The attributes are specified as a json path within the corresponding data object. In the event that the  object is not present (i.e., null), the data extraction should be considered 100% accurate. 


## Get the list of Items

 - [POST /v3/items/get](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1get/post.md): Get the list of items based on the filter criteria provided. If no filter criteria is provided, it will fetch the latest 200 items.


## Get item files

 - [POST /v3/items/get_files](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1get_files/post.md): The  endpoint is used to download the source data for an item. The API returns a byte stream of a zip file.

## Get PDF item

 - [POST /v3/items/get_pdf](https://docs.measureone.com/api/openapi_3.2/openapi/items/paths/~1v3~1items~1get_pdf/post.md): The  endpoint is used to download/view an item as PDF document. The API returns a byte stream of a PDF item file.