# Get the details of Data Request

Get the details of a Data Request. MeasureOne records various events for a Data Request. These events are summarized in the following table.


### Data Request Events

|event|Description|
|--- |--- |
|DATAREQUEST_CREATED| Data Request created|
|DATAREQUEST_UPDATED| Updated the details of Data Request|
|DATAREQUEST_LINK_GENERATED| Data Request link generated|
|NOTIFY_USER_REQUESTED| Email and/or SMS notification sent to user|
|DATAREQUEST_LINK_EXTENDED| Link expiry time extended|
|DATAREQUEST_LINK_EXPIRED| Link for Data Request expired|
|DATAREQUEST_LINK_ACCESSED| Data Request link accessed by user|
|WIDGET_INITIATED| Widget initiated for Data Request|
|DATASOURCE_CLASSIFIED| Individual landed on login screen|
|LOGIN_ATTEMPTED| Individual tried to login|
|INVALID_CREDENTIALS| Credentials provided by user are invalid|
|DATASOURCE_CONNECTED| Individual entered valid credentials and the Data Source is connected|
|INSUFFICIENT_CREDENTIALS| Individual was not able to provide credentials|
|ITEM_CREATED| Item was downloaded and stored database|
|ITEM_PROCESSED| Data extracted and formatted|
|ITEM_UNPROCESSABLE| Unable to process an item|
|ITEMS_AVAILABLE| Data Extraction is completed with some items |
|NO_ITEMS| Data Extraction is completed without an item|
|USER_INTERVENTION_REQUIRED| Individual re-login required |
|DATASOURCE_NOT_FOUND| Individual was unable to find Data Source|
|PLAID_INITIATED| Plaid flow initiated|
|PLAID_CONNECTION_SUCCESSFUL| Plaid connection successful|
|PLAID_CONNECTION_UNSUCCESSFUL| Plaid connection unsuccessful|
|REPORT_REQUESTED| Report requested by customer|
|REPORT_AVAILABLE| Report data is available|
|REPORT_ERROR| Error occurred during generating report|
|UPDATES_AVAILABLE| Updated data for Data Request is available|
|REFRESH_INITIATED| A scheduled refresh is initiated for Data Request|
|REFRESH_FAILED| A scheduled refresh is failed for Data Request|
|CONSENT_REGISTERED| Consent registered forData Request|  
|CONSENT_DEREGISTER| Consent deregistered for Data Request| 
|SESSION_TERMINATED| A session is terminated for Data Request|
|SESSION_LOGGED_OUT| A session is logged out for Data Request|


Endpoint: POST /v3/datarequests/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 Data Request identified by MeasureOne
    Example: "dr_1faOM8Q4efEWIjzdE2SBM2kLq4O"

  - `get_x_auth_token_credentials` (boolean)
    If this value is , the response will contain x_auth_token_credentials object.

  - `get_consent` (boolean)
    If this value is , the response will contain consent object.

## 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 404 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"

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error