Get Files
Get files related to sales invoices (UBL, Attachments, IMR/MLR)
What Files can be retrieved ?
| File Content | Via API | On MyBillit User Interface | 
|---|---|---|
| Main PDF file (PDF invoice) | x | x | 
| Additional attachments (PDF or other) | x | x | 
| File delivered in the network (e.g. UBL file via Peppol) | x | x | 
| IMR and MLR files (can be multiple) | x | x | 
| Evidence file (Proof of delivery) | - | x | 
References to the Files
When executing the GET v1/order command, you also get information about the available files.
Examples of available files:
 "OrderPDF": {
        "FileID": "db40c68c-2ff2-4989-b7d9-6baa1aedff1c",
        "FileName": "Invoice_QS-X014_VILBOXBV.pdf"
    },
    "Attachments": [
        {
            "FileID": "130fd171-72ff-4375-a4ce-1c3a4ac3c61c",
            "FileName": "QS-X014__9_09_2025 8_46_42.json"
        }
    ],    "OrderPDF": {
        "FileID": "5b78345f-a107-4a4e-bf5d-293585a49199",
        "FileName": "Invoice_001t038_XYZBV.pdf"
    },
    "Attachments": [
        {
            "FileID": "01740d1f-5aef-4765-a3ad-dbef1e199a6f",
            "FileName": "test attachment2.pdf"
        },
        {
           "FileID": "c1178d8a-f3d2-452b-a339-c6a67b7bbf99",
          "FileName": "test attachment3.pdf",
        },
        {
           "FileID": "130fd171-72ff-4375-a4ce-1c3a4ac3c61c",
           "FileName": "QS-X014__9_09_2025 8_46_42.json"
        }
    ],    "OrderPDF": {
        "FileID": "75b84e87-acdc-4039-aac1-eebb8184a492",
        "FileName": "QS_001_SalesInvoice.pdf"
    },
    "Attachments": [
        {
            "FileID": "c2d6fd1a-2bfc-4031-b03c-5c2ef7b68168",
            "FileName": "SampleAttachment2.xlsx"
        },
        {
            "FileID": "8c060fb4-e9a3-4ced-97b1-00a9b9feddfd",
            "FileName": "QS-003PDFAttach8__9_05_2025 16_17_25.json"
        }
    ],    "Messages": [
        {
            "FileID": "845e4774-7d76-4d2c-a7de-e6d790cb57c6",
            "CreationDate": "2025-05-07T14:08:07.813",
            "TransportType": "Peppol",
            "Success": true,
            "Trials": 1,
            "Destination": "0208:0446725877",
            "MessageDirection": "Outgoing"
        },
        {
            "Description": "AB: The document has been successfully received.",
            "FileID": "7ee8b70c-3dd7-423a-8269-79f8bc49e0c5",
            "CreationDate": "2025-05-07T14:09:54.203",
            "TransportType": "Peppol",
            "Success": true,
            "Trials": 0,
            "Destination": "0208:0446725877",
            "MessageDirection": "Incoming"
        },
        {
            "Description": "PD: The document has been paid.",
            "FileID": "b39065a9-8c82-4beb-9c04-010435f4c5fa",
            "CreationDate": "2025-05-07T14:25:11.427",
            "TransportType": "Peppol",
            "Success": true,
            "Trials": 0,
            "Destination": "0208:0446725877",
            "MessageDirection": "Incoming"
        }
    ]
}About the 3 examples:
- 1 PDF Attachments (1)
- OrderPDF : the main PDF
- Attachment : Json used for Posting the Invoice/CreditNote
 
- 2 PDF Attachments (3)
- OrderPDF : the main PDF
- Attachments :
- additional PDF attachment,
- additional PDF attachment,
- the Json used for Posting the Invoice/CreditNote
 
 
- 3 PDF and Excel Attachment
- OrderPDF : the main PDF
- Attachments :
- Excel attachment,
- the Json used for Posting the Invoice/CreditNote
 
 
- 4 Messages (UBL/IMR/MLR)
- the UBL file sent via the network
- IMR 1 (AB)
- IMR 2 (PD)
 
How to Get the files?
GET Command of the File
| Endpoint | Method | Response | Extra Info | 
|---|---|---|---|
| /v1/files/FileID | GET | 1 file | Includes full data and file references | 
Point of Attention:
- Your can request 1 file per GET call, so for multiple files you perform multiple gets
Examples of the Result body for a GET File:
{
    "FileID": "57eade47-f402-4605-849b-58c223c6b970",
    "FileName": "140532-206676-9688ab12-2c34-437c-808e-ee279999z99.xml_1.pdf",
    "MimeType": "application/pdf",
    "FileContent": "JVBERi0xLjUKJb662+4KOCAwIG9i................UgL0ltYWdlL1dpZHRoIDUxMi9IZ"
}{
    "FileID": "57eade47-f402-4605-849b-58c223c6b999",
        "FileName": "140532-206676-9688ab12-2c34-437c-808e-ee2793579999.xml",
        "MimeType": "text/xml",
    "FileContent": "JVBERi0xLjUKJb662+4KOCAwIG9i................UgL0ltYWdlL1dpZHRoIDUxMi9IZ"
}{
    "FileID": "57eade47-f402-4605-849b-58c223c9zb999",
    "FileName": "Test Excel 1.xlsx",
    "MimeType": "application/vnd.ms-excel",
    "FileContent": "JVBERi0xLjUKJb662+4KOCAwIG9i................UgL0ltYWdlL1dpZHRoIDUxMi9IZ"
}How to Process a File from Base64
More info: https://docs.billit.be/docs/how-can-i-save-a-file
Updated 4 days ago