# Retrieving MiFIR reporting files

Basically, MiFIR files are retrieved via the `/files` endpoint of the Investment API. The process of downloading data requires the following two steps:

1. [**Retrieving the signed download URL**](#1.-retrieving-the-download-url)
The first API call triggers the creation of a unique download link within our cloud storage infrastructure.
The links are designed to be very difficult to guess, and contain a relatively short expiry time (15 minutes by default).
2. [**Downloading the MiFIR file**](#2.-downloading-the-reporting-files)
The second step is to use the returned URL to download the MiFIR file.


## 1. Retrieving the download URL

Call the Upvest `/file` sharing API endpoint by

**GET**  `/files/mifir_reports/mifir_reporting_files_YYYYMMDD.zip`

Please note that the [file name convention](/products/omnibus/guides/reports/mifir_reports_files#File-name-convention) must be adhered to in order to retrieve the correct MiFIR reporting files.

| URL Parameter | Description |
|  --- | --- |
| `mifir_reports` | The folder name for MiFIR reports. |
| `mifir_reporting_files` | The requested file name. |
| `YYYYMMDD` | The trading date for which the MiFIR report applies. |


**Example response**


```json
{
  "signed_url": "https://storage.googleapis.com/upvest-tooling-datasharing-service-ia-unstable-7263/48785b65bb0459547f9940db7678ef7601dc8826/test.txt?Expires=1680268944&GoogleAccessId=tooling-datasharing-service%40ia-unstable-7263.iam.gserviceaccount.com&Signature=AhbTgjMpKo%2BRB4T5pDEKI3Rw0kCWqyOPvkgKJHpvRKV%2FtSmWi2WvGPShBqc%2FvewnBSnFPeE%2BDrx5fdYSFbZ9WUo3n2BFUtFo%2FRIuh8zNyX5K7og58qO67PRlXKl%2B3HbHDyAx%2FgiOzmAbcIy0Au4LT%2F%2BYe2QMCVxxL7iM%2BPj5toANCyjZflTxM%2BdyZENhgiJ2j6q9uPsjBCP68PFHv%2BIwIIpsJhp9mTOIqH%2Bsbi%2FBckKHtYrrzCV1VzOpKi527y0%2FYUnmWDoV4ADXUmLuH73LlcoQ%2FOjBPvjR7PZCFT2yL4f9CBITfMzFacBDlX4jMZGZq%2BEbd04wxjMWQ%2B3N06zPeg%3D%3D",
  "updated_at": "2023-03-31T12:30:13Z",
  "file_name": "mifir_reporting_files_20230331.zip",
  "content_length": 12345,
  "checksum": "e7947c277cf4e4b36a62d030442d87c7"
}
```

The returned response contains a signed URL that you can use to retrieve and [download the requested MiFIR files](#2.-downloading-the-reporting-files).

## 2. Downloading the reporting files

Use the signed URL returned from [step 1](#1.-retrieving-the-download-url) to download the daily MiFIR reporting files:

**GET** `<PROVIDED signed_url PARAMETER>`