# Get the details of item

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. 


Endpoint: POST /v3/items/get_by_id
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/json):

  - `id` (string, required)
    Unique ID of the Item identified by MeasureOne

## Response 200 fields (application/json):

  - `id` (string)
    Unique ID of the item identified by MeasureOne

  - `datarequest_id` (string)
    MeasureOne generated unique datarequest identifier linked to the item. If this is not provided, MeasureOne will generate a new datarequest for given item.

  - `external_id` (string)
    A customer generated unique identifier linked to the item

  - `datasource_id` (string, required)
    Unique identifier of the datasource. This attribute is non-mandatory  source_data_type

  - `source_data_type` (string, required)
    The type of the source_data
    Enum: "M1_ACADEMIC_RECORD", "M1_DIGEST", "TRANSCRIPT_FILE", "PAYSTUB_FILE", "W2_FILE", "INSURANCE_POLICY (Deprecated)", "AUTO_INSURANCE_POLICY", "HOME_INSURANCE_POLICY", "RENTERS_INSURANCE_POLICY", "UNINSURED_MOTORIST_FORM", "AUTO_INSURANCE_CLAIM", "INSURANCE_CARD", "STUDENT_ID_CARD", "PROCEEDS_1099_B", "TWN_EDR", "FORM_1099_B", "FORM_1099_CONSOLIDATED", "FORM_1099_INT", "FORM_1099_DIV", "FORM_1099_OID", "FORM_1098", "POLICY_LISTING", "POLICY_DETAILS", "VEHICLE_LISTING", "VEHICLE_DETAILS"

  - `media_type` (string)
    Media type of the source data document

  - `duplicates` (array)
    List of item IDs which are duplicate of this item in the datarequest

  - `refresh_id` (string)
    Unique ID of a scheduled refresh identified by MeasureOne

  - `source_data` (array, required)
    Source data object contains one complete academic record. Multiple source data objects containing  will result in an error

  - `processing_status` (string)
    Processing status of the item
    Enum: "IN_PROGRESS", "COMPLETED", "UNPROCESSABLE"

  - `data` (object)

  - `confidence` (object)
    The confidence object represents attributes of an item that the system could not extract with high confidence.  The confidence object will be presented in the response when the item's file format is unstructured. E.g images or scanned PDF files.
The confidence object is presented flat, as dot (.) separated JSON attributes of the item.

  - `created_at` (integer)
    Timestamp for when the item was created

  - `updated_at` (integer)
    Timestamp for when the item was last updated

  - `individual_id` (string)
    MeasureOne generated unique identifier linked to the item. If this is not provided, MeasureOne will generate a new individual_id for given item. This attribute is deprecated

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405

## Response 422 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

  - `reason_codes` (array)
    List of reason codes. Helps developer understand what error occurred during processing an item.

  - `reason_codes.code` (string)
    Reason code applicable
 |Reason Code|Description|
 |--- |--- |
 |UNSUPPORTED_FORMAT| The item can not be processed due to unsupported format.
 |UNPROCESSABLE_DOCUMENT_QUALITY| The item can not be processed due to unprocessable document quality.
 |PARTIAL_DOCUMENT| The item can not be processed due to partial document.

  - `reason_codes.description` (string)
    Description providing details to understand what error occurred during processing an item.

  - `reason_codes.context` (object)
    Context to understand where the reason code is applicable

  - `reason_codes.context.media_type` (string)
    Media type of the source data document Supported Types eg , , , , ,

  - `http_code` (number)
    Error status code

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error