# Get shareable invitation links for Data Request

Get the list of invitation links associated with a Data Request


Endpoint: POST /v3/datarequests/get_invitation_link
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"

## Response 200 fields (application/json):

  - `links` (array)
    List of invitation links associated with Data Request.

  - `links.id` (string)
    Unique ID of the invitation link identified by MeasureOne

  - `links.uri` (string)
    URI of the invitation link generated by MeasureOne

  - `links.expires_at` (number)
    UTC Timestamp at which the invitation link  expires. Upon expiration, the status will be

  - `links.email_notification` (boolean)
    Boolean indicating whether invitation email was sent for the Data Request

  - `links.sms_notification` (boolean)
    Boolean indicating whether invitation SMS was sent for the Data Request

  - `links.status` (string)
    Status of the invitation link
    Enum: "ACTIVE", "USED", "EXPIRED"

  - `links.expiry_reason` (object)
    Reason for expiring the invitation link

  - `links.expiry_reason.code` (string)
    Reason code for expiration
    Enum: "NO_MATCH_FOUND", "INSUFFICIENT_CREDENTIALS", "LINK_TIMEOUT", "DATA_NOT_AVAILABLE", "EXPIRATION_REQUESTED"

  - `links.expiry_reason.description` (string)
    Reason details for expiration.
Reason code:
  *  - When the Individual is unable to find their Datasource
  *  - When the Individual indicates that they do not have valid credentials to complete the Data Request
  *  - When the invitation link times out and reaches its expiration
  *  - When the Individual was able to connect successfully but MeasureOne could not find any data
  *  - When the expiration of the invitation link is explicitly requested by calling  API.

  - `links.created_at` (number)
    Timestamp at which the invitation link was created

  - `links.updated_at` (number)
    Timestamp at which the invitation link was updated

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