# Get the list of Items

Get the list of items based on the filter criteria provided. If no filter criteria is provided, it will fetch the latest 200 items.


Endpoint: POST /v3/items/get
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):

  - `filters` (object)
    Filters that can be applied to fetch the list of Items

  - `filters.id` (array)
    List of unique ID of the Item identified by MeasureOne

  - `filters.individual_id` (string)
    Unique ID of the Individual identified by MeasureOne

  - `filters.datarequest_id` (string)
    Unique ID of the data request identified by MeasureOne

  - `filters.datasource_id` (array)
    List of Data Sources for which you want to find the Data Requests

  - `filters.external_id` (string)
    A customer generated unique identifier linked to the Individual

  - `filters.source_data_type` (array)
    Source data type of an item
    Enum: "M1_ACADEMIC_RECORD", "M1_DIGEST", "TRANSCRIPT_FILE", "PAYSTUB_FILE", "W2_FILE", "INSURANCE_POLICY", "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"

  - `filters.processing_status` (array)
    Processing status of an item
    Enum: "COMPLETED", "IN_PROGRESS", "UNPROCESSABLE"

  - `options` (object)

  - `options.count` (number)
    Number of items required

  - `options.offset` (number)
    offset is used for pagination

  - `options.sort_by` (string)
    Enum: "created_at", "updated_at", "source_data_type", "processing_status", "external_id", "data.pay_date"

  - `options.sort_order` (string)
    Enum: "ASC", "DESC"

  - `options.duplicate_identification_mode` (string)
    Identify duplicate items at datarequest or individual level
    Enum: "DATAREQUEST", "INDIVIDUAL"

  - `fields` (array)
    Fields you want in response. Default fields are , , , , , , , ,

## Response 200 fields (application/json):

  - `results` (array)
    List of Items

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

  - `results.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.

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

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

  - `results.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"

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

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

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

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

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

  - `results.data` (object)

  - `results.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.

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

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

  - `results.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

  - `rowCount` (integer)
    Total results

## Response 400 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 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error